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EXTENSIBLE INFORMATION SYSTEM 

A portion of the disclosure of this patent document contains material, which is 
subject to copyright protection. The copyright owner has no objection to the facsimile 
reproduction by anyone of the patent document or the patent disclosure, as it appears 
in the Patent and Trademark Office patent file or records, but otherwise reserves all 
copyright rights whatsoever. 

This application claims priority of co-pending U.S. Provisional Patent 
Application Serial No. 60/242,041 entitled "Extensible Information System (XIS)" by 
R. Kadel et al., filed October 20, 2000. Priority of the filing date of October 20, 2000 
is hereby claimed, and the disclosure of said Provisional Patent Application is hereby 
incorporated by reference. 

BACKGROUND 

1. Field Of The Invention 

The present invention relates generally to data processing systems and, more 
particularly, to systems that process, analyze, and display data or information. 

2. Descriptiou of the Related Art 

The continuing inroads made by computer technology into the practices of 
information storage and manipulation have opened up new realms of possibility for 
intelligent, informed decision-making. From labor statistics and scientific databases 
like the human genome project to traffic patterns and aircraft positions, the 
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availability of information in electronic form allows sophisticated analysis techniques 
and display methods to be applied at the touch of a button. However this diverse 
array of information also poses significant challenges in areas such as: 
effective organization of information; 

ability to interpret and manipulate information in an increasingly 
wide variety of formats so that data and processing software can 
be brought together in a compatible but also timely and effective 
way; and 

recognizing and navigating relationships between disparate 
information types. 

This task of information management has already grown beyond the ability of 
human operators to keep pace with it, and in most applications, there is far more 
relevant information electronically available on the web and elsewhere than is 
effectively used. The problem is that software affording display of and interaction 
with information must be custom-designed for the particular type and format of the 
information it will work with. This leads to high costs of software development and 
limited availability of software appropriate to information of interest, and poor 
integration between information from different sources. An analyst must use one 
program when dealing with geographic distribution data such as precipitation amounts 
or land use, another for rendering 3-dimensional terrain, another for examining 
congressional districts and voting records, and so on. Many desirable applications of 
available data, such as determining correlations between political party and land use 
strategy in this case, fall between the cracks left by specialized applications, and there 
is no easy way to allow them to interoperate. 

The primary means for allowing one application to operate on the results of 
another are the limited cut and paste facilities offered by many operating systems, 
which allow plain or formatted text or images to be moved between programs. There 
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is no independent way to transfer structured data such as a table of numbers with 
particular column headings, a set of lists of items under specified categories, or even 
something as simple as a single number with an associated unit of measurement. 
From the discussion above, it should be apparent that there is a need for 
5 computer systems that have greater ability to develop, integrate, and interoperate with 
disparate sources of information, to more easily develop software applications, 
components, or objects, and to facilitate interoperation of data between software 
components- The present invention fulfills this need. 

10 SUMMARY OF THE INVENTION 

In accordance with the present invention, a framework for use with object 
oriented programming (OOP) systems provides a framework user with classes that 
comprise a mediation layer that defines an interface between data source components 

15 and data consumer components such that the configuration of the data source 

components can be specified independently of the data consumer components. The 
mediation layer specifies data relationships of the data objects, domain methods for 
defining groups of class attributes, attribute metadata for defining groups of class 
attributes, and change event registration for detecting changes in data values. Thus, 

20 when extended, the mediation layer of the framework can support runtime data 
manipulation between unrelated data source components and data consumer 
components. In this way, the framework provides an extensible information system. 
The framework will be referred to herein as "XIS", and is especially suited to assist in 
the development of information-handling systems or applications. 

25 Data source components that are configured for a non-XIS-aware 

programming environment or framework may still be used with XIS by "wrapping 11 
such source components with code to conform to the interface requirements. Data 
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objects of the well-known "Java" programming language are examples of data source 
components. Data consumer components thus are able to use or consume various data 
source components regardless of the data types and the data source. Thus, once a data 
consumer component is developed within the XIS framework, any data source 
5 components within the XIS framework may also accordingly be used. The 

framework can be provided as a group of APIs (application programming interface). 

The XIS framework of the present invention also includes libraries and APIs 
that provide information management technologies that enable developers and 
integrators to combine XlS-aware components, data sources, and off-the-shelf 
10 JavaBeans into complete systems designed around whatever architecture is best for 
the situation. XIS further supports multiple, dynamic domains and is scalable to n-tier 
systems using the latest technology. The framework enables many developers to 
choose architectures based on their requirements (e.g., server, client/server, 
application server, web server, standalone, hand-held, etc.). 
15 Other features and advantages of the present invention should be apparent from 

the following description, which illustrates, by way of example, the principles of the 
invention. 

BRIEF DESCRIPTIONS OF THE FIGURES 

20 

Figure 1 is a diagram of the extensible information system (XIS) framework 
constructed in accordance with the present invention. 

Figure 2 is a more detailed diagram of Figure 1, showing the various interfaces 
within XIS, constructed in accordance with the present invention. 
25 Figure 3 A is a mqre detailed diagram of Figure 1 , including information and 

services available within XIS, constructed in accordance with the present invention. 
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Figure 3B is a hierarchical structure diagram of an embodiment of an 
InfoModel constructed in accordance with the present invention. 

Figure 4 is a more detailed diagram of Figure 1 showing various information 
available to components within XIS constructed in accordance with the present 
5 invention. 

Figure 5 is a diagram of the semantic representation of a data item within the 
XIS framework constructed in accordance with the present invention. 

Figures 6 A to 6F show data consumer components, particularly display 
components, constructed in accordance with the present invention. 
10 Figure 7 shows a consumer component displaying the properties exposed by a 

data source object constructed in accordance with the present invention. 

Figure 8 is a unified modeling language (UML) diagram of a Person object. 

Figure 9 lists a set of attributes exposed within the XIS framework by the 
Person object of Figure 6 constructed in accordance with the present invention. 
15 Figure 10 illustrates that an object constructed in accordance with the present 

invention may subscribe to more than one domain policy or definition. 

Figure 1 1 shows a domain usage and sequence scenario between a consumer 
component and source component constructed in accordance with the present 
invention. 

20 Figures 12 A to 12D list information regarding a Type Metadata package class 

typically implemented in the mediation layer and constructed in accordance with the 
present invention. 

Figure 13 shows a relationship usage scenario diagram between a consumer 
component and source component constructed in accordance with the present 
25 invention. 

Figure 14 is a flow chart that shows a reference resolution scenario usage 
sequence in which an indirect reference to an information element is created, passed 
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around, and then resolved by two separate data consumers, causing reconstruction to 
occur only the first time. 

Figure 15 lists an exemplary Java source file to implement an information- 
handling application constructed in accordance with the present invention. 
5 Figures 16A to 1 6B list an exemplary Java source file to implement an 

information-handling application constructed in accordance with the present 
invention. 

Figure 17 shows a data consumer component using a source component 
constructed in accordance with the present invention. 
10 Figures 1 8A to 1 8B list an exemplary Java source file to implement an 

information-handling application constructed in accordance with the present 
invention. 

Figures 19A to 19B list an exemplary Java source file to implement an 
information-handling application constructed in accordance with the present 
15 invention. 

Figure 20 shows a data consumer component using a source component 
constructed in accordance with the present invention. 

Figure 21 lists an exemplary Java source file to implement an information- 
handling application constructed in accordance with the present invention. 
20 Figures 22A to 22C list an exemplary Java source file to implement an 

information-handling application constructed in accordance with the present 
invention. 

Figures 23 A to 23D list an exemplary Java source file to implement an 
information-handling application constructed in accordance with the present 
25 invention. 

Figures 24A and 24B show two data consumer components using a source 
component constructed in accordance with the present invention. 

6 
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Figures 25A to 25C list an exemplary Java source file to implement an 
information-handling application constructed in accordance with the present 
invention. 

Figure 26 shows a data consumer component using a source component 
5 constructed in accordance with the present invention. 

Figure 27A and Figure 27B show a flow chart of a data exposure facility 
within the XIS framework constructed in accordance with the present invention. 

Figure 28 is a diagram of how InfoModels constructed in accordance with the 
present invention provide contextualization with the XIS framework. 
10 - Figure 29 is a diagram of the pluggable service facilities within XIS 

constructed in accordance with the present invention. 

Figure 30 shows a flow diagram of a wizard or an API constructed in 
accordance with the present invention that assists in creating XML (extensible 
markup language) DSIs and database DSIs. 
15 Figure 31 shows objects and methods involved in distribution collaboration 

facilities constructed in accordance with the present invention. 

Figure 32 shows semantic repositories for distributed agents constructed in 
accordance with the present invention. 

Figures 33 A to 33P list information regarding a ContentlnfoBean class 
20 constructed in accordance with the present invention. 

Figures 34A to 34D list an information management package typically 
implemented in the mediation layer and constructed in accordance with the present 
invention. 

Figures 35A to 35F list an InfoMbdel interface package typically implemented 
25 in the mediation layer and constructed in accordance with the present invention. 
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Figures 36A to 36B list a package for handling change events typically 
implemented in the mediation layer and constructed in accordance with the present 
invention. 

Figures 36C and 36D show two sequence diagrams showing how change 
5 events are handled and constructed in accordance with the present invention. 

Figures 37A to 37D list an exemplary Java source file to implement an 
information-handling application constructed in accordance with the present 
invention. 

Figures 38A, 38B, 38C, and 38D show two data consumer components using a 
10 source component constructed in accordance with the present invention. 

Figures 39A, 39B, and 39C is list information concerning an AttributeAlias 
class of the framework. 

Figure 40 is a block diagram of a computer device that may be used to operate 
with the framework, in accordance with the present invention. 

15 

DETAILED DESCRIPTION 

The following detailed description illustrates the invention by way of example, 
not by way of limitation of the principles of the invention. This description will 

20 clearly enable one skilled in the art to make and use the invention, and describes 
several embodiments, adaptations, variations, alternatives and uses of the invention, 
including what we presently believe is the best mode of carrying out the invention-. 

The invention will be described by way of illustration with reference to various 
classes, objects, sample codes, etc. written within the exemplary framework, but it 

25 should be understood that such classes, class libraries, application programming 

interfaces, interfaces, objects, etc. may be differently coded, implemented, designed, 
etc. and yet support the functions and features of the present invention. 
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Object-Oriented Technology 

Many application programs and APIs (application program interface) are 
developed using object-oriented (00) technology. Using 00 technology, a system is 
typically developed as a collection of interrelated cooperative objects that are 
5 instances of classes that typically include corresponding states and behaviors; A class 
is a blueprint or template that defines the variables and the methods common to all 
objects that are instances of the class. An object maintains its state in one or more 
variables and implements its behavior with methods or functions. 

Object-oriented programming (OOP) techniques encapsulate, or bind together, 

10 data and the methods that operate on them. This encapsulation permits program 
development to more closely model real-world entities and breaks up program 
development efforts into smaller, more manageable pieces. Although OOP 
techniques have done much to improve program development efficiency, such 
techniques still require a great degree of code generation on the part of developers, 

15 which discourages program reuse. 

Even with OOP techniques, specifying data sources and the way in which data 
will be retrieved or updated from the data sources are still typically hard-coded within 
the objects themselves. An object, for example, may be specified to display pricing 
data (for example, a price display object) and would likely be hard-coded such that 

20 the data source is predefined. Thus, an object may be written to retrieve data from a 
source such as a relational database management system (RDBMS), a spreadsheet file 
such as a spreadsheet in the format of "EXCEL" spreadsheet application by Microsoft 
Corporation, or the object may be written to an XML file. Nevertheless, in 
conventional systems, the price display object would be limited such that if a different 

25 source of data, for example, an XML file rather than an EXCEL file, has to be used, 
the object has to be modified to incorporate access to and manipulation of the XML 
file. Furthermore, if a different set of fields are retrieved, for example, latitude and 
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longitude (i.e., data fields unrelated to pricing information), a new object to display 
latitude and longitude may have to be written to display such information in tabular 
format. 

Table I below shows the data configuration of a typical object. 



Table I 

State/Properties: Name, SSN, position, DOB, and . . ! 
Behavior: RecordQ 

getRecords(DateRange) 

promote Q 



For an application to be able to use this data object, the application would need 
prior Imowledge^ofpbject properties (state) and bchayior._The application would be 
tightly coupled with the class from which the object was instantiated. The meaning 
and intent of the data might be found in the source code or by asking the original 
programmers (e.g., SSN is social security number stored as string rather than a 
numeric type). 

Assuming the object was created by one application written independently of 
another, the object could not be intelligently exchanged between the first application 
and the other with the expectation that the object would be processed unless the 
applications were tightly coupled. A way to have objects be used in various 
applications is thus highly desirable to reduce programming time and resources. 

Common OOP languages include "Java" from Sun Microsystems, Inc. of Palo 
Alto, California, USA, C++, Simula, and Smalltalk. 
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Framework 

The concept of a framework is an important part of 00 programming 
technique. A framework is a specification of the classes and the relationships 
between classes such that the framework defines a class hierarchy that can be used 
5 over and over again, with overrides and extensions. In this way, an initial problem 
solution specified by a class hierarchy can be adapted and customized for new 
circumstances, simplifying program maintenance. In essence, a framework is a set of 
OOP classes that embodies a predetermined set of attributes and methods for 
providing a common group of behaviors. 

10 OOP frameworks have been developed in an effort to further reduce program 

development costs. An application program developer utilizes the framework and 
builds upon it, starting with the classes, attributes, and methods defined by the 
framework designer and adding subclasses and attributes and modifying methods 
depending on the problem to be solved. Such changes to the framework are typically 

15 referred to as framework extensions, and are made possible by the OOP notions of 
inheritance and polymorphism. Thus, a framework can speed the development of an 
00 application program. The challenge confronting framework developers, then, is 
to define a set of classes and methods that best supports the desired problem solution 
and will accept the most likely framework extensions. Thus, the designer of a 

20 framework must carefully assess what framework users will most likely need in the 
way of classes, attributes, and methods. , 

It is therefore a technical advantage of the present invention to provide a 
framework that allows information-handling software to adapt to new data types and 
formats of information, so that a single application built within this framework has a 

25 significantly broader range of compatibilities and domains of usefulness than a 

conventional application and, further, may automatically interoperate at a structured 
level with other similarly enhanced applications. In one embodiment of the present 

11 
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invention, desirable applications of data such as determining correlations between 

political party and land use strategy may be facilitated. 

In an embodiment of the present invention, a single information visualization 

or manipulation application is able 1 to handle many diverse types of information, even 
5 those that are conceived and developed subsequently to the completion of 

development of the application itself. 

In another embodiment of the present invention, information from multiple and 

diverse sources yet sharing some basic feature in common - such as being distributed 

in geographic space, or being distances measured in meters - can be simultaneously 
10 displayed (superimposed) and manipulated within a single application. This invention ■ 

further provides means of access to common data sources such as relational databases, 

extensible markup language (XML) streams, and "Java" programming language 

software objects. 

In an embodiment of the present invention, an information-handling 
15 application is defined as any software application which is capable of utilizing 

digitally available structured information in bulk form, such as from electronic files, 
databases, or internet web sites to provide a display and/or a set of possible 
manipulations to a user, such as after some internal processing and transformation of 
the information such as summarizing it, performing computations on it, or selecting a 
20 subset. Examples include but are not limited to graphing programs, analysis tools (for 
handling financial data, statistical, time series, etc.), and interfaces to geographic 
information systems. Prototypical information-handling applications process 
structured information that has some form of hierarchical and/or modular structure. 
In one embodiment, image and word processing applications are not examples of 
25 what we term information-handling applications. In another embodiment of the 
present invention, structured information in bulk form does not include plain text or 
specific electronic media files such as MP3 files. 

12 
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A conventional information handling application such as a graphing program 
comprises two major components: one component handles the intake of information, 
from storage devices, the network, or user input, and the other component handles the 
display of the information. There may also be parts of the application that perform 
5 computations or transformations on the information before it is displayed. From the 
developer's perspective, a modular piece of software that handles a portion of (or all 
of) the data intake function is a data source component, because it provides 
information to other components within the application. A modular piece of software 
that handles part of (or all of) either the computation, transformation, or display of 

10 information is a data consumer component, because it uses (consumes) information 
provided by the data sources. 

Data sources and data consumers communicate with each other by making 
function calls. The particular functions and their parameters are defined as part of an 
internal version of an application program interface (API). The data consumer 

15 components handle data that is given them through specific calls on their respective 
API, so that information provided through data source components written for 
different applications will not be accepted. This situation provides little opportunity 
for reuse of data source or consumer components, since each is written to interoperate 
only with a specific instantiation of the other. 

20 In an embodiment of the present invention, an internal mediation layer is 

inserted between the data source components and the consumer components that 
expose data structure in a standardized way. Consumer components are constructed 
to use this common API, which is suitable for expressing an extremely wide variety of 
information types. Data source components can be constructed to deliver the 

25 information they take in this format, or a small amount of code can be written to 

translate the output of another source component into the common format. The result 
of the construction is that any consumer component can work with any data source 
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component regardless of the specific nature of the information involved, or whether 
one was anticipated during the design of the other. The common API allows 
consumer components to automatically extract whatever features of information from 
a particular source they are most suitable for displaying or computing with, and also 

5 allows them to utilize all the other features of that information in a generic, 
unspecialized fashion. 

Other embodiments of the present invention comprise: (1) a system for 
representing information such that: (a) a single fixed interface suffices to describe a 
wide range of information types, (b) the information is rendered self describing to an 

10 extent, and (c) relationships between different information elements are expressed; (2) 
an apparatus for allowing this information representation to be employed as a medium 
between data source and data consumer software components; (3) a method and 
apparatus for attaching clarifying material on "intended use" to information so that 
consumer components can handle it more appropriately; (4) a method and apparatus 

15 for providing a context to all information consumption affording control over security 
and visibility of data; (5) a method and apparatus for allowing users to transfer 
information from one consumer component to another through intuitive "drag and 
drop" and "cut and paste" interfaces; (6) a method and apparatus for developing 
enhanced information handling applications based on the foregoing framework; (7) a 

20 method and apparatus for automatically re-representing data from partially self 
describing sources including relational databases, XML streams, and Java software 
objects; (8) a method and apparatus allowing end users using computers distributed 
over a network to collaboratively view and manipulate information; and (9) a method 
and apparatus allowing software components distributed over a network to 

25 automatically obtain annotations on intent and other aspects of encountered data. 

Most aspects of this invention can be implemented in any object oriented 
programming language such as Smalltalk, Objective C, C++, or Java. Certain aspects 
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of it, pointed out below, are especially suited to object oriented languages such as 
Java and Objective C that provide for run time self analysis by programs. However, 
these are in every case peripheral aspects, and the essential parts of the invention may 
be implemented in an object oriented language like C++ without these capabilities. 
5 We will from time to time make reference to a "preferred embodiment" implemented 
in Java, but this should not be taken to be limiting. 

In a preferred embodiment the present invention provides a system and/or 
framework of software components for purposes of aiding development of 
. information-handling applications. The system and/or framework of object-oriented 

10 software components aid the development of applications that read, gather, or receive 
electronic information and allow the display of such information to and manipulation 
by users. These applications are structured in a way so that there are distinct data 
source components and data consumer components. The crucial features of the 
system and/or framework are the fact that data is seen by consumers only through a 

15 standard, conventionalized interface that incorporates: a breakdown into attributes, 
relationships, semantically-annotated "domain methods", event-broadcasting of 
changes in the foregoing to all registered consumers, metadata for each attribute 
providing certain declarative and procedural information including unit of measure, 
content length, data quality, default value, comparator function, summary function, 

20 validation function, and input/output functions for display and user editing within an 
extensible set of interface modalities, related data items available for each data item 
including those in child or generic relationships, and including the ability to store a 
reference without direct access to the related item itself (it can be reconstructed if 
needed), and contextualization such that the attributes, relationships, events, and 

25 methods available for a data item depends on context (see below). 

In a related embodiment, the system and/or framework includes methods for 
data exposure wherein the system determines automatically which method is 
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employed in any particular case, and the choice is invisible to consumers. Exemplary 
methods such as, a data source component which directly provides the standard 
interface, a data source component which is accompanied by a separate Translator 
component which maps its interface to the standard interface; and a data source 

5 component which is automatically inspected by the system to determine what 
available data fields it has, these are exposed to consumers through the standard 
interface as detailed above. 

In a preferred embodiment, the contextualization provided by the system 
and/or framework is accomplished by delegating the final responsibility for data 

10 exposure to an object termed an "InfoModel" which is able to choose which of the 
available attributes and methods on an object should be exposed or hidden, and is able 
to add additional attributes or methods. Preferably, the system and/or framework 
further provides facilities supporting transfer of data items between consumers, either 
by user manipulation (cut/paste or drag/drop) or by internal method calls. When a 

15 transfer is initiated, the data item is passed without its contextual characteristics 
(supplied by an InfoModel) to the receiver. The system and/or framework includes 
facilities supporting the automatic integration of sendee components (generally 
comprising management facilities such as menu provision or running of user dialog 
routines and may or may not have data source provider and/or user interface provider 

20 components) into an application. Integration is handled by a plug-in manager object 
and set of interfaces such that: each service provider is given the opportunity upon 
loading to query all components (data providers or consumers) existing within the 
application for whether they desire the service, and if so what parameters they would 
like to pass to it. The provider then acts on these responses. Whenever new client 

25 components are loaded, they will be queried and possibly responded to by all services 
loaded within the application. 
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In another embodiment a system for importing partially schematized or 
structured data sources (such as a database system or an XML document) into a 
system as described herein. Any application written using the disclosed system 
and/or framework can then utilize these data sources through a standard interface. In 
5 particular, a system and/or framework for performing all or a substantial portion of 
the functionality outlined herein - if it is in connection with a framework or 
application implemented using a framework falling under categories as disclosed such 
as an infrastructure for mediating between information sources and consumers and 
rapidly assembling applications using them. 

10 Thus the present invention provides a method and apparatus involving two 

subsystems, one which processes the schema information for a data source to 
determine the type and metadata information for information attributes from the 
source, and one which processes the instance information. Preferably, the schema 
subsystem processes schematic information such as the type information contained in 

15 an XML schema document or the column information available from a relational 
database management system and sets up appropriate metadata and relationship 
structure for information elements, but it docs not necessarily create any information 
elements. Optionally, additional annotations can be provided by a user in the form of 
a file specifying how to map attributes in the original data to metadata, relationships, 

20 or domain policy attribute or method definitions. Preferably, the instance subsystem 
processes instance information such as that available from an XML document or set 
of relational database rows, for which corresponding schema information can be 
found, and constructs information elements exposed through the standard interface. 
Data consumers can utilize the outputs of these as if they were custom-created data 

25 sources for the type of information described in the schemas. 

In a related aspect, implementation of the invention as described herein for 
both XML and relational databases is provided. In the XML implementation, a built- 
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in data type hierarchy for XML schemas is used to provide types to attributes, and the 
element-subelement-attribute structural hierarchy in XML schemas is used to 
determine relationships between information elements. All documents and schema 
references to other documents are followed up to their sources in order to specify 

5 further attribute or relationship information. A user can optionally specify an XSLT 
(XML Stylesheet Transformations) document that maps the typed data fields found 
from the instance-schema combination into attributes with richer metadata and/or 
references to specific domain policies. In the database implementation, the table 
column heading types from the relational database (date, integer, text, etc.) are used to 

10 provide default type metadata to the attributes of information elements derived from 
table rows of the database. A user can optionally specify a mapping between columns 
or sets of columns into attributes with specific metadata. Furthermore, a user can 
define a sequence of queries for which the results are to result in a hierarchy of 
information elements. For example, for each information element retrieved from, for 

15 example, Query 1 , a parameterized instantiation of Query 2 may be applied to retrieve 
elements which will be exposed as the children of the first information element. For 
each of these elements, a parameterized instantiation of Queiy 3 may be instantiated, 
and so forth. 

Framework Block Diagram 

20 Figure 1 shows a basic block diagram of a framework that is implemented in 

accordance with the present invention. The framework 100 of Figure 1 can be used to 
develop, for example, an information-handling system or application wherein data 
source components 102 and data consumer components 122 are separate and 
independent from each other but can communicate and share data. The framework 

25 1 00 described herein shall be called the extensible information system (XIS) 
framework. 
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From a developer's perspective, a modular piece of software that handles part 
or all of the data intake or retrieval function is a data source component 102. A 
modular piece of software that handles part or all of either data computation, 
transformation, presentation, or display of information is a data consumer component 
5 122. A conventional information-handling application such as a graphing program 
comprises two major components: one side handles the intake of information from 
storage devices, the network, or user input, and the other side handles the display or 
presentation of the information. There may also be parts of the application that 
perform computations or transformations on the information before it is displayed. 

10 XIS Framework 

In the XIS framework 100 constructed in accordance with the invention, there 
may be more than one data source component 102 (also referred to as a source, data 
source, source component, and source object) and there may be more than one data 
consumer component 122 (also referred to as a consumer, consumer object, consumer 

15 component, and data consumer). The data source components 102 provide 

information to other components within the XIS framework 100 via a mediation layer 
1 12, while the data consumer components 122 use the provided information. 

The source components 102 and consumer components 122 that comprise the 
XIS framework 100 are configured such that they communicate with each other in a 

20 manner that is supported by the programming environment in which the framework 
exists, typically by making function calls, via the mediation layer 1 12. In one 
embodiment, the mediation layer 112 consists of a group of application programming 
interfaces (APIs) or class libraries that define a common format for data exchange, 
establishing an information exchange standard. Thus, data source components 102 

25 configured for a different system, application, or framework may still be used within 
the XIS framework if they are "wrapped" in a predetermined way or are suitably 
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modified, as will be known to those skilled in the art, such that they conform to the 
requirements of the data exchange interface of the mediation layer 112. 

A relatively simple block of programming code may be produced to translate 
the output of a data source component 102 into the common format as defined by the 

5 mediation layer or API 112. In this way, any consumer component 122 may work 
with any data source component 102 regardless of the specific nature or type of 
information involved and regardless of whether the data source component was 
known or anticipated during the design of the data consumer component. Because of 
the XIS framework described herein, the data consumer 122 may also extract 

10 whatever features or sets of information that it needs or can process from one or more 
data source, thereby enabling the data consumer to utilize features and information in 
a generic unspecialized fashion. 

The mediation layer 112, which is between the data source components 102 
and the consumer components 122, exposes the data structure of the data source 

15 components 102 in a manner that is common for the framework, preferably through 
an API interface. Data consumer components 122 are constructed to use this common 
API, including utilizing the exposed data structure. The data consumer components 
122 are suitable for expressing an extremely wide variety of information types. In 
addition, the data consumers may be constructed to deliver the information received 
. 20 from the mediation layer to another data consumer component, or to output the 
information received for display. 

Data consumer objects 122 are application or software objects or components 
that use data, or may be said to consume it. Examples of data consumers include 
display programs that display data in tabular format, in graphical mode, in 

25 • organizational chart mode, spreadsheet mode, timeline mode (similar to files in the 
format of the "PROJECT" application from Microsoft Corporation), and the like. 
Data consumers may be desktop based, web-based (Internet-based), distributed 
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architecture, interpreted programs, and the like. Data consumer components within 
the XIS framework may provide display, computational, or interactive facilities. In 
the present description, such specially configured data consumer components are 
referred to as "INFOBEAN" objects, as available from the assignee of the present 
5 invention, Polexis, Inc. of San Diego, California, USA. Those skilled in the art will 
understand how to extend the framework 100 to produce desired applications, in view 
of the description herein. 

Figure 2 shows additional details of the mediation layer 1 12 in the framework 
100. In the framework 100, four special types of interfaces may be exposed to the 

10 data consumer components 122. These four interfaces include Domain Definition or 
Domain Policy 202, Relationship 210, Attributes/Metadata 214, and Change Event 
216. In one embodiment, change events are registered within the XIS framework 100. 
These interfaces may be exposed, for example, through class and object libraries that 
may be developed for the XIS framework. With these pre-defined class and object 

15 libraries and APIs, developers of data , source components 102 and data consumer 
components 122 may independently develop their own source and consumer 
components, thus facilitating development of information-handling applications or 
systems. An example of a class that may be implemented or written in the mediation 
layer to facilitate development of source and consumer components is illustrated in 

20 Figures 33A to 33P, which show details of a sample class called ContentlnfoBean. 
Domain definitions or policies 202 (also referred to as domain objects or 
simply domains) are optional within the XIS framework 100. If defined, the 
corresponding Domain methods 212 for such policies are exposed to the data 
consumers 122. Other information about the domain policy may also be exposed, 

25 such as Attributes/metadata 214 and Relationships 210 for that particular Domain 

Policy. Attributes/Metadata 214, Change Events 216, and Relationships 210 may also 
be exposed within the XIS framework 100, even if domain policies are not defined. 
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Relationships show the relationship between data source components. 
Containment, hierarchies, and ad-hoc relationships, for example, may be shown. 
They may be expressed as "members of ' and references. Relationships are thus 
recognized and may be obtained accordingly, as shown in Figure 14 described further 
5 below. 

Change events may be used to ensure that all consumer or source components 
that have an interest in another source component's data are notified when changes 
occur. Changes may be notified when attributes, members (or containers), or 
references (or referrers) are added, updated, or removed and when values are changed. 

10 Once a data consumer component 122 obtains a reference to a data source 102, 

the data consumer component may obtain access to these interfaces 202, 210, 212, 
214, 216 through method calls in accordance with the programming environment of 
the host computer system. The data consumer 122 obtains such a reference typically 
in preparation to consume or use information from at least a particular data source 

15 102. Examples of such consumer component method calls include: 
get attributes; . 

get member and container information elements; 
get referred and referring information elements; 
get unique ED and selection state; 
20 - add and remove instance specific attributes; 

register to be informed of changes to attributes or relationships; 
and 

invoke method calls of a semantically annotated type, described 
below. 

25 These types of method calls will be familiar to those skilled in the art and familiar 
with the programming environment of the host computer system. 
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Figure 3A is a schematic diagram showing the information about data source 
objects that is exposed by the mediation layer 1 12 in Figures 1 and 2, as well as the 
services available within the XIS framework 100. In accordance with the invention, 
data source components are wrapped with an object that exposes the interface 
5 information for the data source to data consumers through the mediation layer. 

In the preferred embodiment, the wrapper around each data source is an object 
provided by a class called InfoModel. As shown in Figure 3 A, a data source 
comprising a raw data item 35 1, via the APIs 1 12 as described above, offers a variety 
of information, as shown in the blocks 354, 356, 358, 360, 362, through which data 

10 consumers may gain access to the data source. The information represented by the 
blocks 354, 356, 358, 360, 362 is exposed or may be contained within an InfoModel 
350, which provides an information space for all information available in the XIS 
framework 100 for the wrapped data source component. In one embodiment of the 
invention, the data needed by data consumers are accessed via such InfoModels (such 

15 as further illustrated in Figure 28). The wrapper provided by the InfoModel is called 
a LeifiDataltem object 352. Thus, the InfoModel is an interface that permits data 
sources and data consumers of the XIS framework to independently share their data. 
In this way, the methods 360, domains 358, metadata 354, relationships 356, and 
other information of a data source object are thus exposed using the InfoModel object, 

20 which may be said to exist in the mediation layer 112, which sets up contexts for data 
consumption. The XIS framework also provides additional data services through the 
mediation layer, such as the Plug-In Service 264 and BeanContext Sendee 266 
indicated in Figure 3A. These services provide the functionality listed in their 
respective boxes 364, 366. Other data services may be provided, as desired. 

25 The InfoModel object provides a context for information access, i.e., context is 

instantiated through the InfoModel concept. In this way, security may be enforced, 
considering that the conceptual or real "end-user 11 accessing the information is known 
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and thus the underlying data source may be forwarded correctly. Furthermore, 
through this InfoModel concept, an embodiment of the framework may be 
implemented such that attributes and methods may be added or removed by the 
framework user. Original attributes and methods in one context may also be 
5 overridden. 

An attribute is any property of an object. In one embodiment of the invention, 
an attribute may be coded with an "AttributeDescriptor". An AttributeDescriptor is 
provided by the object or its Translator to describe a property of the object using 
TypeMetaData, e.g., how to display it, how to edit it, its permitted ranges, and the 

10 like. Translators map data source-specific structures and types to an XlS-generic 
representation. Translators are further discussed below. Attributes may also be 
defined using Java introspection or reflection, as discussed further below. 

Dynamic attributes may also be exposed within the XIS framework 100. 
These attributes are attributes that are exposed during run time, such as, for example, 

15 a database query wherein each column is an attribute revealed at run time. The 
mediation layer has a mechanism that captures such information. In the preferred 
embodiment, the XIS framework operates in conjunction with a database management 
application, so that the mediation layer utilizes run time database query mechanisms 
that generate metadata of the data object, such as data table column headings, data 

20 types, and the like. Such mechanisms may be provided, for example, by SQL queries 
and the like. In one embodiment, data consumer applications using the XIS APIs are 
unaware of whether an attribute for a data item is obtained dynamically or statically, 
so that the process is transparent to the application user. 

A domain is.a collection of semantically meaningful attributes and method 

25 signatures grouped by their common domain of interest. Examples of domains 

include a Display Domain (a domain that describes how to display information) or a 
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Geo Domain (a domain that specifies how to handle geographic information). 
Domains are further discussed below. 

The contextualization provided by the XIS framework system is accomplished 
by delegating the final responsibility for data exposure to an object termed an 
5 "InfoModel", which is able to choose which of the available attributes and methods of 
an object should be exposed or hidden, and is able to add additional attributes or 
methods. Preferably, the system and/or framework further provides facilities 
supporting the transfer of data items between data consumers, either by user 
manipulation (cut/paste or drag/drop) or by internal method calls. This supports data 

10 sharing among data consumers. When a transfer is initiated, the data item is passed 
without its contextual characteristics (which are supplied by an InfoModel object) to 
the receiver, i.e., only non-contextual information is transferred. In this way, the 
source data may remain unchanged. 

As illustrated in Figure 3 A, a FieldMetaData file 354, a type of metadata, is 

15 used to represent sorting, subset, and visibility criteria for an attribute. This is further 
explained below in conjunction with Examples 1 to 5, wherein subsets of data are 
shown depending on whether "All Attributes" or "Preferred Attributes" are shown. In 
one embodiment of the invention, default behavior method of domain policy attributes 
may also be overridden. Within this framework, context-specific special attributes for 

20 flagging whether a data item should be visible or not (e.g., can be used for display 
filtering, including the XIS value slider, tree checkboxes in the map view, etc.) may 
be defined. This may be achieved through the mediation layer by utilizing a user 
interface to modify display processing for the data item. Furthermore, a selection 
attribute that is a context-specific special attribute for flagging whether an object is 

25 "selected" (and typically should be highlighted) may also be defined. Selected pieces 
of information are often shared among views (context-specific, though), and certain 
operations may be performed on the set of selected objects in a given context 
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The InfoModel objects as described above know how to return a data item (a 
LeifDataltem) given a corresponding raw data source identifier. The InfoModel also 
manages these data items. As indicated in Figure 3 A, an InfoModel may contain one 
or more LeifDataltem objects, each of which provides an interface to a raw data item. 

5 An application developer may use an InfoModel object 350 to get a LeifDataltem 
object 352 in order to use the XIS APIs for accessing the underlying data source in a 
generic fashion. If two different data consumer components ask for a data item (e.g., 
a LeifDataltem) from the same InfoModel for the same raw data source, then both 
data consumers will get the same instance of the LeifDataltem object. InfoModel 

10 objects may also be nested as indicated in Figure 3B. 

Information becomes normalized in the XIS framework so that any application 
can use an object's information by getting attributes and relationships dynamically at 
runtime. Therefore, instead of hard-coding a visualization program to a specific type 
of object, the visualization looks for the attributes it needs to perform its function. 

15 Thus, the developer of the data consuming module may obtain the information needed 
from the XIS LeifDataltem class, which wraps raw data item objects and exposes . 
them to the data consumer through uniform APIs. The visualization can access all the 
information exposed, through the XIS APIs and techniques, as needed. If the data 
source provides AttributeDescriptor objects or translates the properties to domain 

20 attributes, then the information can be interpreted more intelligently in domain- 
specific ways. In one embodiment of the invention, the XIS framework also offers 
APIs and a programming model (or design pattern) that extends Sun's JavaBean 
pattern with XIS information awareness. These extended JavaBeans comprise 
"smarter JavaBeans" that are provided in the XIS framework as the specially 

25 configured INFOBEAN objects and, like JavaBeans, INFOBEANs can be visual or 
nonvisual components, and can be graphically combined in any standard Java 
development environment. 
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InfoModel Class Objects 

In one embodiment,. there are four types of InfoModels in the XIS framework: 
BaselnfoModel : * 

A single BaselnfoModel is required because it is responsible for creating and 
5 caching every BaseDataltem (data item) wrapping a Java object (the raw data item 
object). The BaselnfoModel object holds any object used as a LeifDataltem until the 
data item is no longer needed (i.e., until it is no longer strongly referenced). 
SelectablelnfoModel : 

A super class of BaselnfoModel, this InfoModel delegates to any other 
- 10 InfoModel (typically the BaselnfoModel), and creates SelectableDataltems (data 

items that are selectable). The SelectablelnfoModel objects add a selected Boolean 
attribute and delegate to the LeifDataltems from the prior InfoModel. Since the 
BaselnfoModel is a SelectablelnfoModel, all LeifDataltems have a selected attribute. 
This is true because any LeifDataltem is eitheT in the BaselnfoModel itself, or is in an 
15 InfoModel that is nested in the BaselnfoModel and, therefore, inherits the selected 
attribute from the BaseDataltem. Additional SelectablelnfoModels can be 
instantiated to create independent contexts for selection state, independent of other 
InfoModels. 

AttributeFactorylnfoModel : 
20 This InfoModel allows AttributeFactory classes to be registered so that every 

time a LeifDataltem is created, it enables attribute factories to add additional 
attributes to each LeifDataltem. 

InfoModelSubset : 

A super class of SelectablelnfoModel and AttributeFactorylnfoModel, this is 
25 the simplest InfoModel. It delegates to its parent InfoModel and creates 

LeifDataltems that wrap those XIS data items from the other InfoModel. This 
InfoModel does not automatically add any attributes to the LeifDataltems it creates 
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and manages, but simply provides a context in which data items can be managed. 
Each InfoModel "layer" provides a context in which additional attributes can be 
defined, or existing ones can be overridden. Figures 34A to 34D list an exemplary 
Java package that lists various classes. Figures 35A to 35D list the InfoModel 
5 interface. An interface is a contract in the form of a collection of method and constant 
declarations. When a class implements an interface, it promises to implement all of 
the methods declared in that interface. 
Exposing Data 

Figure 4 is a diagram showing how information from source components may 

10 be exposed to data consumers using the mediation layer 112. The Attribute/Metadata 
interface 214 of Figure 2 exposes a data item 440, 442 as a set of attributes, each of 
which carry a value and a set of metadata that describes the value. A data consumer 
component 420, 422, 424 may obtain information from one or more data items. 
Similarly, a data item 342 may be used by more than one data consumer.422, 424 via 

15 the mediation layer or API 1 12. The information blocks 460, 461 show the 
information available to data consumers. 

A data source component 1 02 may comprise a data source interface (DSI) 
object 412, 414. A DSI object 412, 414 provides a conceptual way to encapsulate 
objects that provide data to the XIS framework 100. A class of a DSI object does not 

20 have to extend or implement any interface. Data is created (instantiated) in DSI 
objects to thereby encapsulate the data and make it available to other objects. The 
DSI itself may also be a data item that simply contains other data items (members). 
The data may be generated internally or extracted from an external source such as a 
database or across a LAN. In addition to creating the data, DSI objects are also 

25 responsible for maintaining and controlling data, such as removing and updating the 
data themselves if such changes are observed in the underlying data used by the DSI 
to create the data. Property change events (216 of Figure 2) may be used by DSIs to 
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communicate changes observed in the original source data items to the listening data 
consumers. 

Any Java object may be a data source component. The Swing JButton, for 
example, is usually a transient object, and not typically retrieved in an information 
5 system. The Swing JButton, however, may still be a data source, if so desired. 

INFOBEANs as stated above are data consumer components 420, 422, 424. 
They are specially configured objects that behave like JavaBeans that process and 
manipulate data in a generic fashion. They are also capable of interpreting and 
optionally displaying XIS data items. INFOBEANs use the XIS framework API's to 
10 gain access to information about data items. 

As previously stated, any Java object may become a data item 440, 442 within 
the XIS framework 100. To make a data item out of JSlider (javax.swing JSlider), it 
simply must be added to an INFOBEAN (data consumer component). Table II below 
provides programming code that makes a data item out of javax.swing. JSlider, thus 
15 exposing the information blocks 460, 461 shown in Figure 4. 



Table II 

Jslider slider = new Jslider(0,l 00,50); 
tablelnfoBean.addRawDataltem(slider); 



The first line of code creates a data item out of JSlider. The second line of 
code adds the JSlider created in line i to the TablelnfoBean object (an INFOBEAN). 
20 In this framework, JSlider knows nothing about the XIS framework, however, all its 
attributes are exposed, to be used and modified. 

There are basic steps that must be performed when creating a DSL First, 
before any code is actually written, a determination must be made as to how the 
original data or data source is to be obtained (e.g., will it come from a database, a flat 
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file, an EJB (Enterprise JavaBean), read from a socket, etc.). This step is performed 
prior to and independent of coding the DSI. Once the data source has been 
determined, it must be decided what attributes of the data source should be exposed 
within the XIS framework. 

5 The DSI component within the mediation layer of the XIS framework has the 

capability of exposing the attributes of a data source. In one embodiment, assuming 
that the data source is a Java object, the attributes to be exposed are determined 
through Java introspection. Introspection is a way to determine a bean's properties, 
methods, and events. Those skilled in the art will understand that a bean is a reusable 

10 software component, which may be combined to build applications. In this scenario, 
no additional code in the consumer component needs to be written. Although 
convenient, this approach is limiting, as it does not allow control over which attributes 
are exposed, and does not allow the user to define custom visualization components or 
express semantics. Furthermore, it requires the Java object to conform to the 

15 JavaBean design pattern. 

Another approach to determining which attributes of a data source should be 
exposed involves writing new code. This approach embeds XlS-aware code directly 
into the Java object. This allows the component developer to directly specify details 
such as the attributes (e.g., via AttiibuteDescriptor) to be exposed along with their 

20 metadata, the Domains to which the DSI subscribes, which Domain methods are 
exposed with what implementations, and more. Writing new code enables greater 
control over the data item (as opposed to the introspection-only case) and provides 
more flexibility in dealing with any Java object rather than just JavaBean objects. 
One limitation of this approach is that the relationships between data items may not be 

25 directly specified. 

Another approach for exposing attributes is to create a Translator class. An 
application developer may place any of the XlS-aware code for exposing attributes, 
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Domains, and the like in this class, as specifying relationships to other data as 
members or as references. This is described further below, in conjunction with the 
description of Figures 21 to 23. 

Referring back to Figure 4, a data consumer 420, 422, 424 may access a data 
5 source via a data source interface (DSI) object defined in the mediation layer 112. 
Communication between the DSI objects 412, 414 and data consumers 420, 422, 424 
in the framework 100 is mediated through a set of application programming interfaces 
(APIs) 1 12 that remain independent of the actual contents and types of the data 
sources. Such APIs are contained in class libraries. 

10 Using the framework 100, a data consumer 420, 422, 424 (for example, an 

INFOBEAN as shown in Figure 6B) may be able to use heterogeneous data sources 
and, thus, eliminate the need to write a particular display software object for each 
particular data source. Within this framework, any data consumer object or 
application may use the data source object's information by getting attributes and 

15 relationships dynamically at run time. Instead of hard coding a visualization to a 
specific type of data source component, the visualization object or data consumer 
looks for the attributes it needs to perform its function. Thus, in this framework, 
developers for source and consumer objects may work independently of each other. 
The DSI object may create any data structure containing members and 

20 references, and may expose any part of that data structure to the framework or system 
100 if it is desired. Since there are no requirements involved to be a data source, a 
visualization bean can also be a data source. The data source can consume data from 
other data sources, and can create new data based on what it has learned. For 
example, DSI objects may be coded to use data source from an RDBMS, e.g., systems 

25 such as provided by Oracle Corporation of Redwood Shores, California, USA and as 
provided by Microsoft Corporation of Redmond, Washington, USA through their 
"ACCESS" application or SQL Server. DSI objects also may use data sources such as 
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XML format data, tabular data (e.g., spreadsheet data such as spreadsheet files in the 
format of the "Excel" application from Microsoft Corporation), email, schedules (e.g. 
schedule data in the format of the "PROJECT" application from Microsoft 
Corporation), data following the SNMP (simple network management protocol), and 
5 the like. 

Objects created by DSIs are considered to be raw objects in the XIS platform. 
These raw objects become normalized objects within the XIS framework when they 
conform to the mediation layer or the API 1 12. In one embodiment, when these raw 
objects are added to an XlS-enabled environment, the XIS framework wraps them 

10 with a normalized object called a LeifDataltem (see Figure 3A) and holds the data 
item in one or more InfoModels. The raw data item could be a simple Java object 
(that does not know anything about XIS) or it can support XIS with direct references 
to AttributeDescriptors and other metadata that are recognized by XIS. The 
mediation layer is implemented in software and runs in-process. It is also exportable 

15 to serve as a distributed middleware if required by a given application. 

An attribute is any property of an object. An attribute 474, 475 typically 
includes identity (ID number) 476, 477, name of the attribute 478, 479, value 480, 
481, and the metadata type or Type Metadata 482, 484, and a description 484, 4S5. 
Attribute names 478, 479 may be the table column header or field name in an 

20 RDBMS. The description of the attribute 484, 485 may be plain text that explains the 
attribute. The value 480, 481 may be expressed as a number, string, or other basic 
data type, or may be expressed as a complex, structured object in itself. 

Referring back to Figure 2, the Attribute/Metadata interface 214 provides for 
fine-grained exposure of an information element or data item 440 442 (Figure 4); by 

25 "fine-grained' 1 is meant that the data item is broken down into a number of aspects or 
characteristics (the "attributes") which are simpler data elements. These might be 
numerical values, strings, arrays, or anything else that can be represented by a 
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software object (but is simpler than the original element). If a data consumer 412, 
414 is not able to handle the entire data element, it may be able to handle some of its 
attributes and therefore may be able to do something useful with it, unlike most 
systems providing interfaces for data integration, which require the entire interface to 
5 be implemented to enable any data usage. 

The Attribute/Metadata interface 214 also makes each attribute self-describing, 
to a limited extent. In accordance with the invention, a data consumer designed 
without regard to a particular type of attribute is still able to display and perform 
limited operations with those attributes by using the metadata types. For example, a 

10 data consumer object or INFOBEAN, which displays an X and Y chart of cost of 
living (expressed as a numerical value) versus geographical location (expressed as a 
territory or state character string, e.g., "California 11 ), may be used to display a different 
set of data contained in another data source component or data item, so long as the 
metadata types of the different sets of data are compatible with the X and Y chart. In 

15 particular, a data consumer component that renders and edits information may still be 
executed, the default value substituted in cases of absence, and statistical 
summarization performed, even if the data consumer component is processing a 
different data source component. Other operations are possible and additional 
metadata may be provided by developers for any identified classes of information 

20 elements (such as number, array, geographic entity, etc.) desired. Because of this, 
data consumer developers may identify the type of auxiliary information or 
procedures provided by the consumer component and then define the interface 
according to which other developers creating data sources should provide or expose 
their metadata. 

25 In one embodiment, any property or attribute of an object may be defined with 

an AttributeDescriptor programming code. When a data source object is enabled 
within the XIS framework, the computing system automatically creates 
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AttributeDescriptors for JavaBean properties and for some public properties. A 
JSlider object, for example, is a JavaBean. JavaBeans have properties that are defined 
by the get<property> and set<property> methods. If the object is a JavaBean and 
provides a Beanlnfo, then it will be honored and treated according to the JavaBean's 

5 specification for Beanlnfo classes. Only properties listed in the Beanlnfo appear as 
attributes. If metadata types, further discussed below, support the property's type, 
then they appear as attributes for that data item. Any properties that do not have 
TypeMetaData support become data items themselves (using the same reflection and 
introspection rules) and are listed in the data item's reference array, retrieved by the 

10 LeifDataltem getReferencesO method (i.e., a method to obtain the references). 

Translators translate various data item classes, thereby enabling seamless integration 
of various data items without code modification. Translators may also be added to 
augment object reflection and introspection, i.e., by developers directly specifying the 
properties of an object. 

15 Table III below lists exemplary programming code to define attributes. Table 

HI shows how to define a SIZE attribute. 



Table III 

public static AttributeDescriptor SIZE; 
static { 

AttributeDescriptorFactory factory = 

AttributeDescriptorFactory.getAttributeDescriptorFactoryO; 
SIZE = factory.createAttributeDescriptbr( 

"size", Your.class, 

new NumericTypeMetaDataC'Size", long.class, 
UnitsOfMeasure.BYTES, 6)); 
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} 



Metadata are data or information regarding data, for example, data type, field 
name, length, value restriction, color, and the like. In practice, metadata are used to 
define the structure and meaning of data objects in tools, databases, applications, and 
other information processes. The data type metadata 482, 483 encompasses both 
procedural and declarative information, including (as appropriate for the value) but 
not limited to the following: 

unit of measure (from the provided unit of measure software 
object, converters to/from other units are accessible); 
content length; 

default or maximum character length or precision of numbers; 
data quality (a rating given by the provider of the data); 
default value (given by the provider of the data type); 
constraints (e.g., numeric range or list of acceptable values); 
formatting; 

comparator function (a procedure which takes two items of the 
data type in question and returns whether one is to be ordered 
before, after, or the same as the other); 

validation function (returns 'true' or 'false* depending on whether 
the value for the attribute passes a certain test or set of tests, tests 
are developer-definable based on an interface which takes a 
software object providing a value and returns a Boolean value, 
but several reference implementations are provided, such as one 
to determine whether a number is within a specified range; 
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list of applicable summary (statistical) functions, summary 
functions are developer-definable based on an interface which 
takes a collection or array of software objects providing values 
and returns a single value (usually, but not necessarily of the 
same type) based on those values, several reference 
implementations are provided, including mean, standard 
deviation, count, max, min, median; and 
renderer and editor procedures for different output modalities 
(examples of modalities include local graphical window, HTML, 
plain text, and WML). 

A renderer displays a value, while an editor allows the user to enter or edit one; 
Tenderers and editors are both developer definable for any modality desired. In the 
preferred embodiment, Tenderers and editors for graphical windows, HTML, and plain 
text are provided. 

In a simple example, a data item may have an attribute called "Manager" 
(attribute name) 478, 479 that has a value of "John Doe," 480, 481 with metadata type 
482, 484 of content length (e.g. "30"), data type ("string"), and default value (""). In 
another example, a data item may have an attribute called "Cost" 478, 479 that has a 
value of "5.00" 480, 481 with metadata type of data type ("float"), default value 
("0.0"), summary statistics ("true"), validation function ("can never be less than 
zero"), and the like. 

The Attribute/Metadata interface specifies generic type accessors for object 
comparing, editing, formatting, rendering, and validation. This displaces the burden 
from the consumer of the data (INFOBEANs) to the developer of the TypeMetaData. 
It enables developers to use existing TypeMetaData to create content that is viewable 
in many forms such as a Swing Component, HTML table, and WML text. • 
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In one embodiment of the invention, the data consumer components are very 
generic, requiring little or no Domain-specific knowledge. For example, a data 
consumer object, for example, which resembles a spreadsheet, displays all available 
attributes of any data item, regardless of the Domain Policies represented. If useful to 
5 this consumer object, the metadata types may provide graphical control components 
for rendering attribute values. They also may supply editor components that give the 
end-user a standard way to modify an attribute, e.g., a color chooser GUI for selecting 
a new color value. 

An input/out metadata class, TypelO, defines the end content format. The 
10 TypelO class offers flexibility in both the input (editing) and output (rendering) of 
attributes according to their type. In one embodiment, a TypelO object is registered 
for a specific TypeMetaData using a registry, for example, the TypelORegistry. The 
registration is performed on the following interface types: HTMLTypelO, 
SwingTypelO, TextTypelO and WMLTypelO. Examples of Type 10 are "Swing 
15 Type 10" (for Java standard user interface library called "Swing"), HTML (hypertext 
markup language), WML (wireless markup language), XML (extensible markup 
language), and text Swing is a graphical user interface (GUI) component kit, part of 
the Java Foundation Classes (JFC) that are integrated into the Java programming 
language. Swing simplifies deployment of applications by providing a complete set 
20 of user-interface elements written entirely in the Java programming language. Swing 
components permit a customizable look and feel without relying on any specific 
windowing system. 

Tabic IV below is exemplary code to register two different TypelOs for the 
BooleanTypeMetaData. 

25 

Table IV 

static { " 
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TypeIORegistry.registerTypeIO(BooleanTypeMetaData.class, 

SwingTypelO.class, 

BooleanSwingTypelO.class); 
TypeIORegistry.registerTypeIO(BooleanTypeMetaData.class, 

TextTypelO.class, 

BooleanTextTypelO.class); 

} 



In one embodiment, the metadata type may be overridden. For example, it is 
possible to override the editing/rendering capabilities of a TypeMetaData. In one 
embodiment, a new TypelO implementation is registered that provides the desired 
editing and rendering. If a developer only wants to affect the TypeMetaData instance 
that the developer is using, a subclass must be created and the TypelO registered with 
that subclass. Thereafter, any instances of the new subclass will use the specified 
TypelO. 

Other features may also be added to the TypeMetaData, such as summary 
function, min function, max function, and the like. For example, 
BooleanTypeMetaData adds summary methods for obtaining the total of false and 
true counts. Exemplary code to perform this modification is listed in Table V below. 



Table V 

static { 

TypeIORegistry.registerTypeIO(BooleanTypeMetaData.class, 
SwingTypelO.class, 
BooleanSwingTypelO.class); 
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TypeIORegistryxegisterTypeIO(BooleanTypeMetaDataxlass, 
TextTypelO.class, 
BooleanTextTypelO.class); 

} 

* Constructs a <b>BooleanTypeMetaData</b> with <i>name</I> 

* @param name the type name, returned by getNameQ. 
*/ 

public BooleanTypeMetaData(String name) { 
super(name); 

addSummaryFunction(new FalseBooleanSummaryFunction(this)); 
addSummaryFunction(new TrueBooleanSummaryFunction(this)); 

} 



Methods may also be added to the TypeMetaData interface to provide standard 
behavior. Constraints may also be specified. Table VI below lists exemplary code to 
5 define a StringTypeMetaData called "Threat" with only three valid values 
("HOSTILE," "FRIEND," and "NEUTRAL"). 



Table VI 

new StringTypeMetaData( u Threat M , 3) { 
{ 

setValidTest( 
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new DiscreteRatigeO { 

• { 

add("HOS"); 

add("FRI"); 

add("NEU"); 

} 

} 

); 

} 

} 



In one embodiment, an INFOBEAN data consumer is given a data item. The 
consumer examines the data item and its attributes, and may also access certain 

5 Domain attributes or execute Domain methods. If the consumer finds something it 
can use, the data item is further processed according to that consumer's function. For 
example, a user might drag a group of data items to an INFOBEAN that displays time 
relationships. The INFOBEAN would ignore those data items that did not have any 
appropriate time-related attributes. For those data items that have time-related 

10 attributes, the values can be obtained and used to populate a user interface. 

Referring back to Figure 2, the Domain Definition/Policy interface 202 
provides a means for the intended use of an attribute in a data item to be conveyed 
along with the attribute itself. A domain policy typically comprises a list of attribute 
types with metadata and a list of function calls applicable to data possessing some or 

15 all of the attributes with parameter specifications, annotated with English text 
expressing the intent (i.e., description of the attribute). It is a group of related 
attributes (or properties), along with their semantics to usefully deal with data 
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processing those attributes, particularly to define the specific intent of the attribute or 
method. The semantics are specified in the attribute TypeMetaData and in natural 
language. Software developers of both sources 102 and consumers of data 122 may 
refer to a domain policy in making design decisions, thereby ensuring that an attribute 
is handled in a more sensible manner than the limited self describing capabilities 
provided by metadata alone would allow. Domain policies indicating intended use of 
a set of information that are well understood, for example, by experts now may be 
mapped and aligned so that common features of different sources of data may be 
combined along common lines. 

A domain policy typically has no knowledge of the data items that use the 
attributes from those domains or the data consumer components that use them. 
Domains are just a related collection of Attributes and methods from which the 
various data item classes are free to choose. 

In one embodiment of the invention, every data item in the framework . 
provides a list of domain policies it "subscribes to" when requested by a standard 
method call. For example, a geographical domain policy is defined within the 
framework 100 to handle a set of three numerical values (longitude, latitude, and 
altitude) to define the position of, for example, an airplane. This domain policy or 
domain interface is defined in the mediation layer 1 12 so that the data source 
component 102 and the data consumer component 122 may interface with each 
properly. In this scenario, data source component 102 exposes the three numerical 
values properly (i.e., as latitude, longitude, and latitude). The data consumer 
component 122, on the other hand, understands this pre-defined domain policy and 
thus is able to properly handle these three attributes or values, such that, the location 
of this airplane may be plotted on a map (like the one shown in Figure 1 A), distances 
between positions calculated, and the like. 
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Two or more modules (consumer and source) may subscribe to the same 
Domain. This, however, does not preclude the modules to be developed 
independently . A Domain Policy in one embodiment is defined by Java classes that 
declare a set of attributes and methods that might be supported by a given data item. 

5 For example, a temporal domain defines start time and duration as attributes. A 
timeline may only be properly plotted if such software object understands which 
attribute represents the start time and which attribute represents the duration or the 
end time. For this to work in XIS, two classes would need to exist: TemporalDomain 
and TemporalDomainWrapper. The TemporalDomain class defines the 

10 AttributeDescriptors (i.e., attributes) for each domain attribute; and the 

TemporalDomainWrapper class provides accessor and mutator (get and set) methods 
for these attributes. The wrapper also may declare one or more domain methods, 
which can have any signature to be invoked with the data item as the target object. 
The wrapper is a convenience class for accessing domain attributes, providing 

15 optional default values, and invoking domain methods through Java reflection. 

Analyzing any domain yields a list of attributes and methods. Though much 
like a class definition in form, Domain Policies are supposed to convey and define 
logically independent characteristics related only by their domain context. It is very 
important not to fall into the trap of accidentally creating a domain that reflects a 

20 particular class or interface, or to add implementation-specific details that have 

nothing to do with conceptual domains into a given Domain Policy. An application 
can obtain and manipulate attributes of an object via a domain wrapper instead of 
accessing the object directly. This eliminates the dependency on the class of the 
object An application can now be written with only the knowledge of domains. No 

25 prior knowledge of a particular data source is required at development time; only 
domains. 

42 



WO 02/46916 



PCT/US01/48418 



In one embodiment, attribute aliases may be used. This enables one attribute 
to be substituted for another. This is typically used when two domains are defined 
that have similar attributes. This enables a consumer to ask for the Attribute from the 
domain that it knows about, and have the value translated from the Attribute of the 
DSI from the second domain. In one embodiment, the mediation layer implements 
this in a seamless operation, i.e., either the consumer or provider of the Attributes 
knows that it was an aliased Attribute, for example, "speed in knots 11 and "velocity in 
meters/sec 11 . 

In another embodiment, methods of Domains may be registered with domain 
method descriptor factories similar to AttributeDescriptors. In this implementation, it 
enables developers to reference domain methods via these static singletons, determine 
if domain methods of interest are defined, and to determine all information about the 
argument types and interpretation of the domain method. Furthermore, like the 
attribute descriptor factory (AttributeDescriptorFactory), developers pass the 
necessary ingredients or information to this factory, and the factory handles the 
internal registration of the method parameter types, return type, exceptions, and 
interpretation. It ensures that one and only one object in the Java runtime exists for 
each distinct domain method definition (each unique method signature), similar to 
attributes and attributes factory. 

Figure 4 shows a schematic diagram of information that may be exposed by a 
data item 510 (440 and 452 in Figure 4). In an embodiment of the present invention, 
a data item 510 is defined as any unit of information that can be represented by a 
single object (perhaps containing subobjects) in an object oriented programming 
(OOP) language and is a coherent unit in terms of the semantics of the content domain 
that it relates to. Thus, data items are defined within a common semantic 
representation. Each information element is defined in terms of entities (data source 
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or data consumer component), identity, relationships, attributes (name/value), services 
(not just data), and change events (dynamic nature). 

For example, a single row in a relational database containing information on a 
person's name and address constitutes an information element, but so would the table 

5 from which it comes, and even the entire database itself. Different levels or 

granularity of information is useful in the context of different applications, but any 
one of them can be considered an information element for purposes of our exposition. 
An example of a noncoherent unit would be a random collection of name/address 
rows from a database, unless there was some comprehensible unifying characteristic 

10 to them (e.g., all rows for addresses in the state of Utah). 

Data items use Domain Policy attributes and methods to express the data item 
characteristics in a "normalized 11 manner. That is, a data item may expose Domain 
Policy methods 512, which are the functions or methods 516, 518, 520 of a particular - 
Domain Policy to characterize the data item's behavior and attributes to characterize 

15 the data item's information content. A data item may also expose Domain attributes 
and metadata. A data item may also be part of more than one Domain Policy, thus a 
number of Domain methods 512 may be exposed with such data item 510. The 
Domain methods define the method name, possible input parameters, which may be 
mutable objects, i.e., input/output parameters, and optional return value. This shows 

20 the expected behavior of the method, expectations of the inputs, and return value 

constraints. The data item may also expose one or more attributes 530 and 538. Each 
attribute 530, 538 may have an attribute value 534, 542, an attribute descriptor 532, 
540 (containing, among other information, an English text description of the 
attribute), and type metadata 536, 543. The type metadata may include the class type 

25 5 44 (the class type of the attribute's value) and type input/output 546 (TypelO, for IO 
facilities). Examples of class type are LatLonAlt (for latitude, longitude, altitude 
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data), String (string data), Integer (integer data), Date (calendar date), Color, and the 
like. TypelO, as discussed above, may indicate the input and output format. 

The Relationships 522, e.g., containment, hierarchies, and ad-hoc relationships, 
of a particular data item 510 may also be exposed as shown by the data items 524, 
526, 528. A data item may have zero (none at all) or may have many data 
relationships to the other data items via Domain methods and attributes. 

Additional information exposed by a data element is a metadata override, 
which may be used to override a default behavior of a Domain Policy attribute. For 
example, default formatting of a date for some Domain Policy may be overridden, 
from MM-DD format (two digits for month and two digits for date) to "month text 
string" and DD format. In one embodiment, this may be implemented by assigning 
different metadata to an attribute using FieldMetaData within the XIS framework. 

User Interface 

Figures 6 A to 6F are exemplary representations of computer display windows 
produced by data consumer components 122, which may be developed within the XIS 
framework 100. These data consumer components may use any data source 
component 102 for data and may also be run without an associated data source 
component. 

Figure 6 A shows a computer display window called "Map View 1" produced 
by a mapping program for an INFOBEAN object that contains vector shoreline data 
from a data source component to produce the world shoreline depiction in the drawing 
figure. If an appropxiate data source is loaded into this INFOBEAN, then appropriate 
additional pieces of information will be displayed, e.g., as geographic points on the 
depicted world map. Appropriate pieces of information for this INFOBEAN may 
include numeric data, which may, for example, be mapped to a set of latitude, 
longitude, and altitude coordinates on the map display of Figure 6A. 
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Figures 6B to 6D show window displays of a file manager or information 
exploring component, much like a file system explorer, called "XIS Explorer" with a 
vertically oriented directory frame on the left side of the window display and two 
stacked information detail frames on the right side. The directory frame on the left 

5 may provide a tree diagram of available DSI components and their relationships to 
other components. Figure 6B shows that the Explorer View display does not contain 
any data (the "Explorer Contents" menu is empty). Figure 6C shows the XIS 
Explorer program after it is loaded with data called "Orders", "Computer", and 
"People Source" data sources, with "People Source" selected. Detail information 

10 about the People Source data is shown in the two stacked right frames. The upper 
right frame shows a listing of data objects or entries in the People Source data source, 
and the lower right frame shows attributes of a particular data object in People 
Source. A different set of data objects or records is shown in Figure 6D, this time for 
the "Orders" data file. That is, Figure 6D corresponds to the Figure 6B display after 

15 XIS Explorer is loaded with the "Orders" data. Thus, detail information about the 
orders is shown in the two right frames. Figure 6D shows that a listing of data object 
names can be provided in the left tree diagram frame. As indicated by the display 
windows shown in Figures 6B to 6D, the same data consumer component or 
INFOBEAN-generated display format (Figure 6B) may be used to display different 

20 data source components (Figure 6C and Figure 6D, e.g., "People Source" and 
"Orders"). 

Figures 6E and 6F show a graphing program INFOBEAN display. Figure 6E 
shows the window display when it does not contain any data, while Figure 6F shows 
"Orders" (the same class of data objects shown in Figure 6D) loaded and displayed as 
25 a graph. This shows that the same data source component .102 may be utilized by 
more than one data consumer component to display different types of data 
characteristics and carry out different operations on the data, as shown in Figures 6B 
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through 6F. Thus, different INFOBEAN data consumer components can be 
configured to produce the desired data operations and window displays from available 
data objects (sources). 

Figure 7 shows a computer window display for an INFOBEAN data consumer 
component, showing the property sheet of a particular data source object called 
"Person." This "Person" object may be a Java object. Those skilled in the art will 
understand that JavaBeans are a specification developed by Sun Microsystems that 
defines how Java objects can interact. An object that conforms to this specification is 
called a JavaBean. This object may be used by any application that understands the 
JavaBeans format. For example, the "INFOBEAN" objects available from Polexis, 
Inc. of San Diego, California, USA are objects that behave as JavaBeans that can 
process data in a generic fashion, looking for and manipulating data pertaining to 
particular domains as generated by DSIs or other INFOBEANs. 

Data consumer objects may also be Java objects that present and/or process 2D 
and 3D maps, table/spreadsheet data, hierarchies (trees), plots (bar, scatter, pie, etc.), 
gantt/timeline, content (e.g., email), organization charts, calendars, properties or 
attributes, and the like. 

Figure 8 shows a unified modeling language (UML) class diagram for a Person 
class source data. Using the XIS framework of the present invention, the data 
consumer, an INFOBEAN, obtains information, particularly, the attributes listed in 
Figure 7 (e.g., SSN, Display Name, DOB, and Name) of the Person object. This set 
of information is shown in blocks 460 and 461 in Figure 4. This is performed, for 
example, by using a naming convention for methods, i.e., GET + "Attribute Name." 
An API determines the available methods of an object and determines attributes based 
on method names. For example, an API from "getDOB," "getName," and "getSSN" 
methods determines the attributes DOB, Name, and SSN, respectively. Java 
introspection may also be used. 



47 



WO 02/46916 



PCT/USO 1/48418 



Figure 9 shows the different attributes obtained or exposed for the Person 
object (i.e., DOB, SSN, and Name). In addition, using the toStringO method, 
available for every object in Java, as shown in Figure 6, the DisplayName attribute is 
also exposed. 

5 In one embodiment, no Translator exists for the Person object. Also, there are 

no static get<PropertyName>Descriptor methods defined, so the only XIS Domain 
Attribute is the displayName that is obtained, by default, from the toString() method 
available in every object in Java. The remaining attributes (date of birth, Social 
Security number, and name), though not mapped to a Domain, are available through 

10 the mediation layer API. 

If an XIS Translator were used or if the Person class specified XIS 
AttributeDescriptors, then the Java fields could be mapped to domains. In this case, 
for example, the birth date and Social Security number could be mapped to 
corresponding attributes in the "Personnel Domain". Within this domain, the 

15 attributes would be specified with detailed TypeMetaData, which is made available so 
that the data from the attributes, such as the Social Security number, can be 
appropriately validated, displayed, edited, formatted, and otherwise processed 
wherever that attribute is used. 

Figure 10 shows how an object, particularly a data source component, may 

20 belong to multiple domain policies. In this case, for example, the domain policies 
include the Geo Domain (geographical domain), Movement Domain, and Display 
Domain. The Geo Domain has defined at least two methods called GetLatLonAlt and 
SetLatLonAit. The GetLatLonAlt method obtains the latitude, longitude, and altitude, 
while the SetLatLonAit method sets these parameters. The Movement Domain 

25 contains a GetCourse method, which obtains the course or direction of an airplane, for 
example. The Display Domain has two methods called GetDisplayName and 
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GetBrushColor, which obtain the name of the object and display the color of the 
object, respectively. 

Figure 1 1 shows a sequence diagram of a domain policy usage scenario. In 
this time sequence diagram, each column represents an entity (i.e., user display 1 102, 
5 data consumer component 1 104, and data source component 1 106), and time or 
sequence flows from top to bottom. Here, a data consumer software component 
(middle) requests a data source to tell it the Domain Policies to which the data source 
subscribes. Upon receipt of the information, the data consumer checks to see whether 
these include the Geo, Movement, and Temporal Domains, which it recognizes. The 
10 developer of the data consumer need not have known about this particular source, nor 
the data source developer known about the particular consumer, for these two 
components to interoperate correctly: the data consumer plots three numbers given to 
it by the source as position, speed, and a time duration (computed by a call to a known 
function on the source), as they were intended by the source's developer. In the XIS 
15 framework, applications and components that comply with the Domain Policy API are 
able to share data in a simple yet powerful manner, ensuring automated integration 
and reuse. Thus, data sources and data consumers may be independently developed. 

In one embodiment, attributes of a given domain are exposed through the static 
final AttributeDescriptors of that domain. The AttributeDescriptors that make up any 
20 given domain are built using the AttributeDescriptorFactory. If the developer of a 
data item class uses a custom AttributeDescriptor, then it should be built (typically in 
the Translator) using this factory. 

Table VII below shows exemplary code that illustrates how a DisplayDomain 
builds its font attribute. 



Table VII 
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public static final AttributeDescriptor font; 
static { 

AttributeDescriptor tapFont = null; 
try{ 

AttributeDescriptorFactory factory = 

AttributeDescriptorFactory.getAttributeDescriptorFactoryO; 
tmpFont = factory xreateAttributeDescriptor( 

"font", 

DisplayDomain.class, 

new com.xis.types.FontTypeMetaDataCTont 1 ') 

); 

} catch (Throwable t) { 
t.printStackTraceO; 

} 

font = tmpFont; 

} 



Providing the font parameter to the factory means that the expected method 
names for accessing the attribute will be getFontO and setFontO- The exception is 
5 thrown if the attribute has already been registered with that domain. The primary 
integral ingredient of an AttributeDescriptor is the appropriate TypeMetaData. 

Figures 12A to 12D list an exemplary Java package called com.xis.types and 
its respective classes. In one embodiment of the invention, several packages 
containing various classes to implement the features of the present invention are 
10 contained in class libraries or APIs. 
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Referring again to Figures 2 and 4, the set of Relationships 210, 472, 473 that a 
given data item 440, 442 possesses with other data items is also exposed through 
standard method calls. One method retrieves the "member elements" belonging to a 
given element in a parent-child relationship. These members are directly referred to 
5 by means of conventional object "pointers". 

Figure 13 is a block diagram representation of how relationships between data 
items within the XIS framework 100 are exposed in a generic fashion. Member-of 
(i.e., hierarchical) and reference relationships are supported 

Members enable the creation of a hierarchical data structure. A data source 
10 object may also have members themselves. When members are added or removed, it 
is the data source's responsibility to fire the appropriate events to inform any listeners 
that the data structure has changed. By nature, certain objects have members (like 
Collections or arrays). In one embodiment, the actual array is returned to the object 
requesting the relationship. 
15 A reference represents a pointer or a reference to an object. In one 

embodiment, an object may be referred to without instantiating that object until 
necessary. References in the XIS framework may also provide persistable or 
persistent data to define a link and may also refer to software classes/objects on how 
to later resolve such link to an actual live data item. These references may also 
20 provide annotations (e.g., description of links and their roles with respect to data 
items). 

Figure 14 shows how references may be resolved. Information regarding 
relationships, as stated above, may be obtained using object pointers, e.g., there is an 
object pointer from one data item to another data item to indicate a parent-child 
25 relationship. In this way, data source components may be able to determine which 
data items are directly or indirectly children of which others and the general 
relationships between data items. This set of relationship information may be used in 
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displaying and representing the data items with its own characteristic fashion. This 
relationship information, for example, may be helpful in an organization chart or an 
explorer-type consumer component. Relationships, for example, may be a "peer-to- 
peer" or "members of f type. 

5 In Figure 13, for example, a data consumer Component A 1320 requests the 

relationship of a data source component 1313 (Source 1), via the mediation layer 1 12 
shown in Figure 1. Via the same mediation layer 1 12, the data source component 
(Source 1) 1313 returns a data item, which indicates the relationship of the data 
source component or data item, as shown in Source 1 1315. Similarly, the same data 

10 consumer Component A 1320 may request the relationship of data source component 
1330 (Source 2), and such relationship information is returned 1325. Another data 
consumer Component B 1340 may also obtain the relationship information of the data 
source (Source 2) 1330, i.e., the result 1335. As shown, the resulting relationship 
information 1325 and 1335, e.g., how the relationship is represented may depend on 

15 the data source component, for example, the relationship information shown in the 
box 1325 is different from the box 1335. 

In one embodiment of the invention, a unique ID for a data item is available in 
the current runtime environment. Such unique ID for a particular item need not be 
recreated (or a new unique ID created) except when the data has been completely 

20 unloaded and then reloaded, e.g., loading of a row from a database, unloading it, and 
then reloading (will usually result in a new unique ID). 

A second method retrieves links representing a more general and indirect form 
of relationship comprising a text annotation and a reference object which can be used 
to either obtain the referred data item (or information element) or retrieve or 

25 reconstruct it if it is not directly available. This retrieval or reconstruction need not 
take place until the moment the referred information or data element is actually 
needed. In particular, the reference refers directly to a "resolver" object on which-- 
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when retrieval is actually requested— a method is called with arguments also specified 
in the reference. This method then returns the desired information element or data 
element. 

This mechanism is quite general; one possible implementation would be a 
5 resolver object able to make queries on a database and construct data source objects 
from the result. The reference could specify the particular query to be made, with the 
effect that a very small reference (comprised primarily of a query string, assuming the 
resolver class is loaded as part of the general mechanisms within the application) can 
be passed around between application components and only resolved into a large, 

10 memory intensive data object when some operation (such as display to a user) needs 
to be performed on it. Other types of reference retrieval mechanisms not involving 
databases are possible, such as query of network based services or collection of direct 
user input, i.e., anything that can be implemented within the implementation language 
can be used as a reconstruction procedure. 

15 Additional methods on a data element may be implemented to provide 

Relationship information in the reverse direction ,that is, to the elements that contain a 
given element and elements that refer to a given element may also be acquired 
through direct queries. 

Finally, a more dynamic form of information is accessible through a 

20 standardized mechanism by which interested data consumers 122 or sources 102 can 
register— through calling a particular method on the data source object 102— to receive 
events whenever one or more chosen aspects of a data source change. In particular, a 
data source maintains lists of those software objects interested in hearing about 
changes in attribute values, the addition or removal of attributes, the addition or 

25 removal of members or containers, and the addition and removal of references or 
referrers, and whenever one of these aspects changes, it sends a message to each 
object on the appropriate list. This mechanism, founded on the event passing 
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mechanisms found in many object oriented programming languages and libraries but 
centered around information structure as exposed generically within the XIS 
framework, enables different components of an application to "keep in sync" with 
information sources that change or grow during use. In other words, if a data source 

5 signals a change in an information element, all displays and computations can be 
updated immediately to reflect the change, much like a dynamically adjusting 
spreadsheet program. 

Figure 14 is an exemplary flow diagram that shows how a reference is resolved 
within an XIS framework. In the first block 1410, a data consumer component 

10 Consumer A produces or creates a reference to a data item Data X. In the next 
operation 1420, this reference is saved to disk, e.g., as a text file. In the next 
operation 1430, the data consumer component Consumer A is restarted and the 
reference is retrieved from the file saved in the previous operation. In the next 
operation 1440, such reference is also passed to data consumers Consumer B and 

15 Consumer C. Next, at 1450, Consumer B requests resolution of the reference. This 
resolution is done in the next operation 1460, wherein Data X is constructed through 
executing a database query. This database query is stored as part of the reference 
information stored in the disk (block 1420). The query returns the data item Data X, 
which is then used by Consumer B (block 1470). Consumer C may also request 

20 resolution of the reference (block 1480). Considering that data item X has been 
resolved by the data consumer component Consumer B, Data X is not reconstructed 
again from the database, rather a cached yersion is directly returned instead (block 
1490). This operation 1490 assumes that no change in Data X occurred. 
In one embodiment of the invention, the XIS framework models 

25 communication after the JavaBeans PropertyChange mechanism. Figures 36A to 36B . 
show a listing of an exemplary package, com.xis.leif. event, which includes interfaces, 
event objects, and default implementation adapters for events in the XIS framework. 
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The UML sequence diagram shown in Figure 36C shows how a data source 
interacts with an INFOBEAN. In particular, it shows how a data source and an 
INFOBEAN interact when data is added. The INFOBEAN gets a LeifDataltern for 
that object and adds a listener. When the data source updates the object, or if any 
5 other INFOBEAN updates the LeifDataltern, the LeifDataltern fires events to all 
listeners. 

Each INFOBEAN may choose to listen for changes in the data it is using. If it 
would like to receive updates, it must attach a LeifDataltemListener to each data item 
to which it would like to listen. Thus, when something changes in the data, the 
10 listener receives the event. Upon receiving this event, the listener updates the 
corresponding data item if the change is one that concerns the INFOBEAN. 

Figure 36D shows a UML sequence illustrating how a data source and 
INFOBEAN interact particularly when data are updated. 

In one embodiment, state attributes are defined to assist in determining change 
15 events as well as management of references. The state attribute describes what state 
the data is in at any time. This may be implemented to determine whether a data item 
should be kept and whether to display it, for example, without listening to the parent 
of the data, if there is one. Exemplary states are defined below: 

(1) Deleted: When a raw data item is in this state, it is no longer 
20 being used and should be discarded. 

(2) Exists: When a raw data item is in this state, the data exists and 
is still being referenced as either a member of another raw data 
item or it is a DSI itself. 

(3) Live: This state includes everything in the Exists state. This 

25 state also means that the data item is also connected to a live data 

feed such as a database or server and that the connection is still 
alive. 
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(4) Dead: This state includes everything in the Exists state. This 

state also means that the data item was, at one point, connected to 
a live data feed, but the connection to the data feed no longer 
exists. An example of a Dead state is when the connection to a 
data server goes down and the data still exists in the DSI, but can 
no longer be updated. 
To better help understand the features of the invention, sample information- 
handling applications, using Java programming, are exemplified and discussed below. 
Example 1 * < 

Figures 15 and 16 show two Java source files to implement an application 
within the XIS framework. The output is shown in Figure 17. 

Figure 15 lists the HelloWorldjava source file that creates a HelloWorld 
object, which is a data source component. This source file is a minimal Java object 
that satisfies the method conventions for a JavaBean, in this case, it contains "get" and 
"set" methods (which often but need not necessarily correspond to private member 
variables), and a toStringO method. 

Figures 16A and 16B list the TestHarness.java source file that creates a 
TestHamess object, which is a data consumer component. TestHarness contains all 
the code to access all the information exposed within XIS and display its 
properties/attributes using a PropertySheetlnfoBean. The PropertySheetlnfoBean is a 
data consumer component, which displays the attributes of a data source component. 

Referring back to Figure 16A, as shown in the portion of code 1602, many 
standard classes of the Java language are used. In addition, a set of classes provided 
within the XIS framework, particularly within the mediation layer, is also used, e.g., 
com.xis.leif.im.BaseInfoModel. The code for the class library for the com.xis.leif 
class is not shown herein. Various alternatives relating to what classes are needed 
would depend on how the XIS framework of the present invention is implemented, 
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designed, and the like, as will be known to those skilled in the art in view of this 
description. 

The first line in mainO of the HellbWorldjava code 1604 prevents the XIS 
PluglnManager from starting up. The PluglnManager is used for tying components of 

5 a large XIS application together based on resource files it finds associated with their 
classes. The PluglnManager is further discussed below. This feature is set to "off 1 to 
reduce the time to startup. 

The lines of code shown 1606 in the first part of this source file sets up a 
predefined XIS InfoBean, in this case, PropertySheetlnfoBean that is capable of 

10 displaying the available attributes of an object. The attributes are obtained through 
the Java language reflection method, which are used to make a wrapper object in the 
addRawDataltemO call. This means that the addRawDataltem method in the 
"properties" class is predefined within the XIS framework. This addRawDataltem 
method will ultimately result in the invocation of the reflection feature of Java so that 

15 the various attributes contained in the data source HelloWorld object are exposed to 
be used by the PropertySheetlnfo. 

The PropertySheetlnfoBean uses the wrapper to access the attributes for 
display and, if necessary, enable the user to update the exposed attributes of the 
object. In this example, however, none of the attributes are editable. The 

20 PropertySheetlnfoBean also fires a close event when a "Cancel," "OK," or close 
button is pressed. The next portion of code 1608 sets up a Java listener to exit the 
program when the appropriate button is pressed. 

The last portion of code 1610A and 1610B creates a JFrame (Java frame) to 
display the INFOBEAN (it extends java.awt.Component). A listener is added to exit 

25 the program when the window is closed. 

Figure 17 shows the resulting display application on INFOBEAN called 
PropertySheetlnfoBean. Example 1 is very simple, as it simply displays the attributes 
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exposed for the HelloWorld object in a tabular format. Pressing a "close window" 
display button causes the application to exit. 

Example 2 - • ........ 

Figures 18 A, 18B, 19A, and 19B list two Java source files. These two Java 
5 source files function similarly to those listed in Figures 15 and 16. Modifications or 
additions to the code listed in Figures 15 and 16 are marked with 7* {*/" <new code 
here> "/*}*/} The resulting output is shown in Figure 20. 

Figures 1 8 A and 1 8B extend the previous HelloWorld class (Figure 1 5) by 
using the JavaBean standard property change event distribution classes so that other 
10 XIS objects are automatically notified when its properties are changed (within the set 
methods). The java.beans. Property ChangeSupport instance takes care of maintaining 
lists of listeners and sending events to them. It is only necessary to implement 
wrapper methods to pass listeners to this contained instance (the first block of new 
code after the imports 1802) and then to call the firePropertyChange method 1804 on 
15 it when anything is actually changed. This is performed in the setValue 1808 and 
setMyColor 1810 methods. Value and My Color are editable fields. 

Figures 19A and 19B contain the TestHarness file. Similar to Figures 16A and 
16B, the TestHarness file contains code to expose an instance of this object within 
XIS. In this case, not only are the properties or attributes displayed using a 
20 PropertySheetlnfoBean, but a charting program, ChartlnfoBean, i.e., another data 
consumer component uses the same data item to display a chart accordingly. The 
ChartlnfoBean automatically searches for numeric attributes on the data item and 
plots them accordingly. The Numeric attributes are recognized as such through 
reflection when the raw data item, HelloWorld object, is wrapped within a 
25 LeifDataltem object. 

Similar to Figures 16A and 16B, the TestHarness file contains code to expose 
an instance of this object within XIS. In this case, not only are the properties or 
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attributes displayed using a PropertySheetlnfoBean, but a charting program, 
ChartlnfoBean, i.e., a data consumer component feeds the same data item to display a 
chart accordingly. The ChartlnfoBean automatically searches for numeric attributes 
on the data item, and allow them to be plotted. The Numeric attributes are recognized 
5 as such through reflection when the HelloWorld object was registered within the XIS 
framework. 

The first portion of code 1902 sets up a property sheet INFOBEAN similar to 
Example 1 . The second new code portion 1904, marked in the drawing by comment 
braces, sets up a second frame and puts a ChartlNFOBEAN into it. Since the chart 
10 can display multiple data items, the method to feed it data items (addRawDataltems) 
1906 takes an array of objects. The method setChartType 1908 may be used to 
specify the type of chart, its axes, and so on. 

Figure 20 shows the PropertySheetlnfoBean displaying the attributes of the 
data item, i.e., the HelloWorld object. The charting component is not shown in the 
15 ■ figure. 

Example 2 application puts up two windows-a property sheet displaying 
information on a HelloWorld object and a chart display (alternatively called a "plot 1 ' 
display) showing one or more of the numeric attributes of the same data item. On the 
property sheet, editable fields are surrounded by a darker gray background. In 

20 particular, one may change the "My Color" property by clicking on it. Clicking on 
this property brings up a default editor for color attributes defined within this 
framework. In this embodiment, numbers, strings, dates, and several other kinds of 
attributes all have appropriate editors automatically set up for them within XIS, via 
the TypeMetaData facilities. 

25 The chart starts out displaying either the ID or the Value attribute. It may be 

changed by clicking on the Y axis label. This is also the way to set which kind of 
chart (bar, line, pie, etc.) is used. If the value being plotted (or the color) is changed 
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in the property sheet (and the display button "Apply" is pressed), the chart 
automatically updates. Similarly, right clicking on the part of the chart corresponding 
to a data item enables a user to bring up its property sheet. In this embodiment, this 
kind of coordination is maintained automatically within the XIS framework through 
the use of the JavaBeans event mechanisms. It should be noted that when the 
application is run or executed, the color of the chart does not match the one set in the 
property sheet. This is because, although the PropertySheet recognizes that any field 
of type "java.awtColor" is displayable and editable as a color, the chart has no way of 
knowing which color field (if there are more than one) should be used. This may be 
solved, however, within the framework by using standardized Domain Attributes. 

In one embodiment of the invention, Translators are used within the XIS 
framework. As described earlier, a DSI exposes data information within the XIS 
framework for data consumers to use. Java reflection and introspection may be used 
to obtain attributes specified in simple objects and JavaBean, respectively. The XIS 
framework first searches for a Translator class for the data source object. Translators 
are therefore optional considering that the attribute values and attribute descriptors 
may directly be obtained from an object. Translators may also be used in order to 
keep the object's class simple so that it is capable of being used in non-XIS 
environments. 

In an embodiment, Translators are somewhat similar to the Beanlnfo class in 
JavaBeans. Like the Beanlnfo class, the name of the class must begin with the name 
of the data class followed by "Translator". For example, a DSI class named 
PlanObject Java would have a corresponding Translator class 
PlanObjectTranslator.java. Also, similar to Beanlnfo classes, Translators must reside 
in the same class space in which the DSI is located. For special circumstance cases 
such as non-localized objects or custom Translator definitions, a Translator registry, 
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e.g., TranslatorRegistry, may be used to register a Translator for a given data item 
class. 

Table VHI below shows an exemplary code to register a Translator within the 
XIS framework. 



Table Vni 
// register the translator for File objects 

TranslatorRegistry.getTranslatorRegistryO 

.registerObj ectSchema(PlanObj ect. class, 
PlanObjectTranslator.class); 



The above code, as well as all code discussed herein, is provided to illustrate 
the functional behavior described herein. One of ordinary skill in the art will be able 

10 to produce the code, for example, to create classes, objects, APIs to affect this 
Translator registry. 

When the value of an attribute is requested from a data source component, 
using the mediation layer, the value from the attribute methods specified in the 
Translator, if any, is exposed. If the Translator does not exist, then the method in the 

15 object is invoked, i.e., the gett-attribute method within the data source object. The 
Translator may directly invoke the object's methods as well. The Translator may also 
be used to wrap legacy code. For example, if the object class is a legacy code, which 
may not be modified, and has a color property, a Translator may be written to return 
the value of the color, for example, for the DisplayDomain.color attribute. In this 

20 way, the information may be accessed without modifying the original legacy code. 
The data in the data source object in effect has been normalized or tailored to the 
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domain policy specified. The XIS framework in this embodiment provides the ability 
to integrate existing data item classes without modifying them. 

To integrate a data item class into the XIS framework, an accompanying 
Translator class should be provided. In this Translator class, the data source 
5 developer provides code that reaches back into the data item's class to expose its 
properties. It also serves as a way of normalizing access to these properties by 
imposing a common interface for all Translators to implement. 
Translators have two primary functions: 

(1) Translators provide an intermediate method from the caller of an attribute 

10 "get" or "set" method to the data source object, enabling a developer to translate the 
value from its internal representation to a representation understood within the 
framework, particularly, by the data consumer components. For example, an object 
may store a default color as a string color name, but the Translator may convert that 
color to a java.awt.Color object. 

15 (2) Translators also enable a developer to define attribute types more precisely 

(e.g., via AttributeDescriptor code, which provides detailed TypeMetaData and may 
map attributes to specific domains). This resolves any ambiguity in the attribute type. 
It should be noted that reflected properties that are converted into XIS attributes carry 
minimal semantics, which contributes to the usefulness of the XIS framework. For 

20 example, "float getDegrees()" by itself does not imply whether it provides an angular 
measure or a temperature measure, nor does it imply that the valid range is from 0 to 
360 or from 0.0 to 2.0 pi for angular measures, or distinguish between Fahrenheit, 
Celsius, or Kelvin for temperature measures. 

Translators also enable developers to convert objects that do not follow the 

25 JavaBeans get/set API design pattern. For instance, a data item could be implemented 
as a mapping of attribute names to values (e.g., String, Integer, Double, and Boolean). 
The Translator may map actual XIS attributes to these key/value combinations, 
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making XIS data items appear as if they were generated from the more typical 
JavaBeans-style objects. Example 3 shows how a Translator may be implemented in 
the XIS framework. 
Example 3 

5 Example 3 application is contained in three source files listed in Figures 21 , 

22A, 22B, 22C, 23A, 23B, 23C, and 23D. The resulting outputs are shown in Figures 
24Aand24B. 

Example 3 functions similarly to Example 2 above, but enable finer control 
over the data item attributes exposed within XIS. In particular, the HelloWorld object 

10 is explicitly wrapped in a Translator rather than simply feeding it to XIS and letting it 
rely on reflection to display and manipulate the data. This allows some properties of 
the raw data item to be hidden, and allows other ones to be better "understood" within 
XIS. The HelloWorldTranslator Java file contains the Translator. 

Referring to Figure 2 1 , the property change event-handling portion of code 

15 1506 found in Figure 1 8A has been removed from the set methods. These functions 
are now handled in the HelloWorldTranslator class (Figures 22A-22C), which is 
registered with XIS by the TranslatorRegistry static call at the beginning of that class. 

Referring to Figures 22A to 22C, this file contains the HelloWorldTranslator 
class 2202 that wraps the HelloWorld object. When an INFOBEAN encounters a raw 

20 data item, it ultimately accesses the raw data item through a Translator's methods, if a 
Translator exists. In one embodiment, all Translators are subclasses of the 
com.xis.leif.im.Translator class, which provides an infrastructure that facilitates the 
use of attributes already defined or set-up in an XIS Domain. Such attributes have 
type metadata predefined for them, and many XIS INFOBEANs automatically access 

25 and utilize the metadata and the attributes themselves. 

. The first member variable 2204 of the HelloWorldTranslator class lists the 
predefined XIS domains from which attributes are taken. In order to use an attribute 
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not in one of these domains, it may be necessary to provide a separate metadata for it. 
The second member variable 2203 defines an array, which lists auxiliary information 
on the fields, in this case, whether they are displayed by default in the property sheet 
display. The getFieldMetaDataArray method 2206A and 2206B fills this array, if 

5 necessary, with the default metadata for the fields that are exposed by the get and set 
methods further listed below in the source file. The exception to the defaults is that 
the "course" attribute 2208 is not visible, i.e., it is not displayed under the "Preferred 
Attributes" on the property sheet. It is displayed, however, when the "All Attributes" 
option is selected. Other things that may be set (but are not in the source file) include 

10 the sorting order and rank when multiple data items of this class are listed together, as 
in a table. 

The ensuing get and set methods 2210 define the attributes that the rest of the, 
XIS objects can see. In general, this refers to the enclosing raw data object, but this 
need not always be the case. For example, here, the Hello World's integer Value* 

15 property is map to the 'speed 1 attribute, which takes its metadata and its type (double) 
from the Movement domain 2212. The Movement domain has previously been 
defined. By handling conversions within the Translator, the rest of XIS "never 
knows" that there is really an integer value underneath. 

All change event propagation is handled through the request objects passed 

20 into the set methods 22 14. Similar to Example 2, all XIS objects using the same data 
item are notified of the change. 

Referring to Figures 23 A through 23D, the TestHamess code is largely 
unchanged from Example 2, but at the end it includes a separate class that 
demonstrates how attributes may be altered on a data item that includes a Translator. 

25 In general, the procedure is to obtain, first, the LeifDataltem corresponding to the raw 
data item, then a "domain wrapper" that wraps this and enables access to attributes 
that come under that domain. Internally, the domain wrapper calls methods on the 
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Translator, but externally it presents an interface to the developer that depends only 
on the domain and not on the particular LeifDataltem being wrapped. 

The code in the Accelerate class is a standard thread implementation that uses 
the wrapper to successively change the HelloWorld data item's speed attribute. In 
5 other embodiments, this attribute may be altered by any portion of the program that 
has access to the data item. Because the wrapper eventually calls the Translator, the 
change events are propagated appropriately. 

The Example 3 application, similar to Example 2, displays two windows-a 
property sheet and a chart. Example 3 shows that the property sheet may be made to 
10 display more properties (in this case, the "course 11 attribute) by selecting "All 
Attributes" from the top menu, which ignores the "preferred" setting in the 
FieldMetaData. The attributes all have reasonable names, which come from the 
metadata stored in the domains. Finally, if the "Pen Color" attribute is edited, the plot 
changes color accordingly. This is because the Chart INFOBEAN recognizes and 
15 uses the "Pen Color" attribute from the Display Domain if it finds one on the data 
item. Because of the various wrappers employed, it does not matter what kind of 
object is eventually underneath or what other attributes it has; as long as the "Pen 
Color" attribute is found, it will be used. 
Example 4 

20 Example 4 contains two source files namely HelloWorld and TestHarness. 

Figures 25A to 25C list the HelloWorldjava source file. This example shows 
translation without a Translator class. The resulting output is a property sheet 
INFOBEAN and a Chart INFOBEAN. Figure 26 shows the property sheet InfoBean, 
but the ChartlNFOBEAN is not shown. The HelloWorldTranslator.java file from 

25 Example 3 is eliminated. Similar to above, the HelloWorldjava file has been marked 
such that changes from Example 3 are marked by open and close commented braces. 
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The Java source files enable some of the same fine control over the attributes 
exposed within XIS (see Example 3) without using a separate Translator class. If a 
developer has control over the Java code for the data source, the overhead of using a 
Translator may be eliminated by building some of its functions directly into the data 
5 source. It may, however, still be desirable to use a Translator because this avoids 
building any XlS-specific code into the JavaBean created and enables the code to be 
more streamlined for use in non-XIS contexts. 

Figures 22A to 22C contain the HelloWorld code, which include some of the 
code from Example 3, with some additional code for exposing attributes and 
10 providing field metadata as the HelloWorldTranslator class in Example 3. In fact, 
almost everything may be done from within this data item class that could be done 
with a Translator except for two things. First, attributes cannot be hidden from XIS-- 
everything with a get() method is exposed. Second, Translators may be used in 
conjunction with security features, for example, embodied in the XIS framework to 
15 restrict access to visible properties in a generalized fashion across all data items. 

The first portion of code 2502 provides methods for XIS to obtain information 
on which data item properties have attribute information provided for them. The XIS 
components first introspect on the data item to find its properties, then try to call the 
get(property name)Descriptor for each property. For those instances where this fails, 
20 the XIS component may provide its own attribute descriptors where it recognizes the 
type of the attribute. For example, the property sheet recognizes Color, Numeric 
(various subtypes), Date, and String attributes. The next portion of code 2504 
initializes a PropertyChangeSupport instance, because property change events must be 
handled here, similar to Example 2. 
25 Following this are several methods unchanged from Example 3, but the set() 

methods have been altered to resemble those from Example 2 in which property 
change events are fired. Next, there are several new get() and set() methods which 
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expose the properties with the same names as the Translator did in Example 3. These 
names correspond with the getAttributeDescriptor methods listed above in the code, 
and the XIS components interpret them accordingly. These properties show up as 
preferred attributes in the property sheet, whereas those properties without 
corresponding attribute descriptors become nonpreferred attributes. 

The portion of new code 2506 following this provides field metadata for this 
raw data item. This program code is almost identical with those in the Example 3 
HelloWorldTranslator, except that both the variable and the method are now static, 
and the "Course" attribute removed to reduce clutter. 

The TestHaraess file for Example 4 is generally unchanged from Example 3, 
except the code to register a Translator is removed. The portion of program code 
2302 in Figure 23A is removed in this example. 

This Example 4 application is largely similar to Example 3, except that if the 
"All Attributes" option is chosen under the property sheet, then the previously 
unexposed 'Value", "myColor", and other attributes appear. The chart is also able to 
display the "value" and "ID" properties. 

Figure 26 shows a window display of the property sheet output from the 
Example 4 application. 

Processing Flow for Exposing Data 

Figure 27A and Figure 27B show a flow diagram of how information about a 
data item, e.g., a data item as shown in Figure 5, is exposed to data consumer 
components. In the preferred embodiment, data exposure within the system may be 
accomplished by one of three methods, described further below. There are two 
primary functions to be performed: (1) interfacing with an internal or external data 
source such as a set of disk files, a database, or a web service; and (2) exposing the 
resulting data according to the standard interface outlined above, e.g., following the 
domain interface, relationships interface, and the like. 
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In the first method of exposure, one software component performs both 
functions; in the second method, separate software objects perform the two functions; 
in the third method, which is only implementable in an object oriented programming 
language that provides self-analysis facilities, such as Objective C or Java, the . 

5 exposure function is performed automatically by the system. More particularly, in the 
first method, a data source interface (DSI) software object is written that connects to 
an external data source such as a local file system, an Internet site, or an RDBMS. 
The DSI object converts the information provided by the external data source into the 
information representation or data item that may be consumed by data consumer 

10 objects as described above. In a preferred embodiment of the invention, the data 
source DSI objects are from the LeifDataltem class. 

In the second method, the API of an existing software data object is accessed 
by a Translator object, which then exposes the information to other data consumers in 
the representation format discussed above. This arrangement is referred to in the 

15 object oriented design literature as an Adapter or Wrapper pattern. See, for example, 
Gamma, E., Helm, R., Johnson, R., Vlissides, J. (1995); Design Patterns: Elements of 
Reusable Object Oriented Software; New York: Addison-Wesley. This is generally 
referred to as "wrapping". More precisely, a data consumer component requests 
information from the Translator object, which then converts the request into 

20 something the original data source object can deal with. The consumer then converts 
that object's response into the appropriate format for a response to the original call. 

The third method applies the facilities within a self-analysis-capable 
programming language such as Java or Objective C. This type of programming 
language enables an object to determine the available data fields and function calls 

25 afforded by another object while an application is running. In the preferred 

embodiment implemented in Java, the queried object must be a "JavaBean" according 
to Sun Microsystem's suggested convention, with "getO" and "setO" method calls. 
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Each data field available through one of these calls, or by virtue of being a "public" 
variable, is examined, and the resulting type information is used to expose both the 
field's value and appropriate metadata to data consumers. If the field is a numeric 
type (double, Double, float, Float, Integer, int, long, or byte in Java), it is exposed as a 
5 decimal or integer with an "unknown" unit of measure. If the field is a string (String 
in Java), it is exposed as a text element. If the field is a complex object, it is exposed 
as a linked element via a reference (discussed above), unless a special class has 
registered to handle the complex object type within the application context or XIS 
framework. 

10 In another embodiment, in addition to the facilities for exposing data, the XIS 

framework provides an apparatus for allowing application context to affect how 
information is exposed. This is illustrated in Figures 27A, 27B, and 28, described 
further below. The attributes, methods, and relationships available for a given data 
source are determined by a surrounding structure called an InfoModel. The 

15 InfoModel connects the pieces of the XIS framework together. It is an interface 

comprising an object that knows how to return data item information. See also Figure 
3A discussed above. 

In another preferred embodiment, an application comprises one or more Views, 
each containing and providing an InfoModel to one or more data consumers, termed 

20 INFOBEANS as described above, which may provide display, computational, or 
interactive facilities. All of the Views are in turn managed under a single ViewHost, 
which provides the global application context. Conceptually, a view represents a 
single perspective of the current data. One single perspective (or view) could be quite 
different from another because of the ability to add/override attributes in a view. 

25 View creates a new InfoModel that in turn creates new LeifDataltems that are used 
within that view. This is done to separate context sensitive attributes between an 
InfoModel and another View, INFOBEAN, or InfoModel, Views are also used as a 
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controller of one or more INFOBEANs by managing the data flow to each individual 
INFOBEAN. Al! Views are also by definition INFOBEANs since they manage 
information flow with generic means. The ViewHost is used to manage the complete 
set of Views and INFOBEANs, thus presenting each view to the user in a uniform 
fashion such as frames, windows or other display mechanisms. 

Figure 27A and Figure 27B show a flow chart of a data exposure facility 
within the XIS framework constructed in accordance with the present invention. The 
diagrammed operations will occur when the XIS framework is loaded into program 
memory of a computer system that supports an object oriented programming (OOP) 
environment, as will be understood by those skilled in the art. In the first processing 
step, at block 2702, a data source object is registered within the XIS framework of the 
computer system. When a data item is brought into the framework, it is exposed to 
data consumer objects, e.g., via an InfoModel, typically via one of three methods. The 
first operation is to determine whether a Translator object is available and whether the 
Translator object is registered for the raw data object type. This processing is 
represented by the decision block 2704. 

If the Translator is available, an affirmative outcome at the block 2704, then at 
block 2760 the data item attributes, methods, and Domains are obtained via the 
Translator. If the Translator is not available, a negative outcome at 2704, then at 
block 2706 the data item object is scanned to find the data object's methods. The 
scanning may be accomplished with facilities of the OOP environment of the host 
computer system, such as InfoBeans. 

After the data item object has been scanned at block 2706, the system next 
checks to see if the data item includes an XlS-standard data exposure interface (that 
is, a predefined interface known to the XIS framework). If the standard interface is 
available, an affirmative outcome at block 2714, then at biock2762 the data item 
object attributes, methods, and Domains are obtained from the data source object 
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itself. The system then checks for references to Domain Policies at block 2763. If 
there is no standard interface available at the decision block 2714, then processing 
moves to the block 2764, where the facilities of the programming language of the 
OOP environment are used to interrogate the data item object to determine the object's 
5 accessible data fields. Processing then moves to exposure attribute processing via the 
off-page connector B to Figure 27B, described below. 

Returning to block 2762, after the data item attributes, methods, and Domains 
are obtained, a check is made for Domain Policy references at the decision block 
2763. If there are references to Domain Policies, an affirmative outcome at the . 

10 decision block, then at block 2765 a check is made to determine if there is 

FieldMetaData override for a Domain. If there are no Domain overrides, then at 
block 2710 the definitions from the referenced Domain Policy are used for the 
attribute metadata. The processing then moves to exposure attribute processing via 
the off-page connector A. If there are Domain overrides, an affirmative outcome at 

15 block 2765, then at block 2716 the system uses the definitions included with the data 
item object Translator for the attribute metadata of the data item. The processing then 
moves to exposure attribute processing via the off-page connector A. Referring back 
to block 2763, if there were no references to Domain Policies, then processing 
proceeds straight to block 2716 to obtain the attribute metadata definitions and then to 

20 the exposure attribute processing via the off-page connector A to Figure 27B. 

Turning to the processing of Figure 27B via the off-page connector A, the data 
item attributes are exposed to the local InfoModel class (i.e., a DSI object). Next, at 
the decision block 2770, a check is made to determine if the data item has any 
dynamic attributes. If the data item does, then at block 2772 the framework 

25 processing adds the dynamic attributes to the available data item attributes. If the data 
item has no dynamic attributes, or after any dynamic attributes have been added, 
processing moves to block 2773, where the system checks to determine if a Translator 
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was provided (registered) for the Data Source object. If a Translator was provided, 
then at the decision box 2775 the sy stem checks to determine if reflection has been 
requested Those skilled in the art will understand that reflection is an operation that 
is provided by most OOP environments, such as by Java. 

5 If reflection is to be performed, then processing returns to Figure 27 A via the 

off-page connector C, whereupon the Data Source is scanned* If reflection is not to 
be performed, or if no Translator was registered (a negative outcome at block 2773), 
then processing moves to the decision block 2774. At block 2774, the system checks 
to determine if the data item has registered any extended Translators. If there are no 

10 extended Translators, then at block 2718 the data item attributes are derived, added, or 
hidden, depending on the data context gleaned from the DSI. The data item is then 
fully exposed to data consumer components for use (block 2790). If there are 
extended Translators, an affirmative outcome at block 2774, then processing returns 
to Figure 27A via the off-page connector B to obtain the information from such 

15 Translators (block 2760). 

Figure 28 is a diagram showing how InfoModels provide contextualization 
within the XIS framework. The initial "raw" object (e.g., Java object or data from 
RDBMS) provided by the data source is exposed through mediation by successive 
"wrapping layers" of other objects, which determine which fields are visible, and 

20 possibly performs conversions or consolidations. Each "View" within the XIS • 

framework, which contains one or more "INFOBEAN" consumers, carries with it its 
own context. Feeding a data source component to a consumer component places it 
within that context. 

When a data element provided by a data source is introduced to an InfoModel, 
25 the InfoModel actually provides a new element derived from this one to consumers. 
This derived element provides the actual data source interface discussed above: The 
attributes, type metadata, and methods provided for the element are first determined 
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as described below under "data exposure facilities". Then the InfoModel inspects the 
results and decides whether to add or derive any new attributes, or to hide existing 
attributes. Once the data is added to an InfoModel (discussed below), it may be asked 
for by other components for processing and visualization purposes. 
5 In another embodiment, the ViewHost, a data consumer component, provides 

facilities allowing interactive cut and paste and drag and drop of information elements 
between different consumer components. When a cut-and-paste or drag-sand-drop 
occurs, each information element is decontextualized and then recontextualized inside 
the new InfoModel into which it is placed. This means that some attributes 

10 previously available may be removed, whereas others, more appropriate to the 
functions of the recipient consumer(s), may be added. 

Referring back to Figure 28, this figure shows how multiple InfoModels work 
to share references to raw objects. This figure also illustrates how an INFOBEAN 
and/or a DSI adds objects to the InfoModel to obtain data items. The DSI 2815 

15 creates an instance of source raw data item (e.g., Java object) 2830. The original 

source objects are maintained by DSI and one or more InfoModels have references to 
these source objects. The raw data item 2830 is provided to or may be used by an 
INFOBEAN (data consumer) via the addRawDataItem() method. (Please refer to 
Table III above. The second line of code shows that the source object is added to the 

20 TablelnfoClass.) 

The INFOBEAN 2820 requests the data item for the raw object 2835 (which 
was the source object 2830) from its InfoModel or the BaselnfoModeL The 
BaselnfoModel as discussed above is responsible for creating and caching every data 
item (wrapping any object). Each InfoModel is considered to contain a subset of data 

25 items from the entire set of data. The InfoModel is a view of the BaselnfoModel, 
thus, there may be data items in the BaselnfoModel that are not present in the 
InfoModel used by the INFOBEAN. The circles 2828 shown in the InfoModel 2805 
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represent attributes, domains, relationships, etc. from the BaselnfoModel. For 
example, Figure 6 contains a list of information that an INFOBEAN may obtain about 
the Person object, in this case 2830, 2835, through the LeifDataltem API. In addition 
information from nested InfoModels are inherited. An InfoModel 2805 also always 

5 adds new items to the BaselnfoModel, e.g., common attributes such as "selection" are 
delegated. These new items are also exposed to the INFOBEAN as shown by the 
number of circles in 2840. 

The BaselnfoModel 2810 returns the raw data object 2845 to the InfoModel. 
The InfoModel 2805 returns a data item 2840, which exposes the information, for 

10 ■ example, shown in Figures 4 and 5 to the INFOBEAN 2820. A data item 2845 (see 
Figure 4) is returned, which may have been created or may have already existed in the 
InfoModel. 

In the XIS framework, as shown in the InfoModel, attribute and method 
"requests" mechanisms are available. Standard mechanism to retrieve the current 

15 value of any Attribute, or set the current value, if the Attribute is mutable, may also be 
. easily implemented. In one embodiment, this mechanism also enables a standard 
syntax and mechanism for the invocation of any domain method. 

These attribute and method "request" objects contain all of the information 
necessary for the data source to fulfill the requested task. It contains the actual 

20 ("raw") data item whose attribute value is being sought or set (along with the desired 
new value), or whose domain method is being invoked. They also contain contextual 
information, such as the current User, allowing data source developers to implement 
full user-based information access and security controls, and a context for obtaining 
services (implemented through the Java "BeanContext" APIs). This is significant 

25 because it enables the process of executing methods and/or getting or setting values to 
leverage services "in context" such as the current data view (or window) through 
which to interact with the user. These request objects also contain contextual "data 
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item" (e.g., LeifDataltem), as opposed to the "raw" non-contextual data item, from 
which to get additional or overridden values or execute additional/overridden 
methods, if appropriate to the task. In another embodiment, these "Request" objects 
are not only passed when getting/setting values, or executing domain methods, but are 
5 also passed to all other "Translator" methods that take and may need to access or 
manipulate the data item. The "Request" object not only provides context, but also 
ensures that the DSI (via the Translator) always has what it needs (particularly, the 
User information) to manage its security constraints, if any. 

A data item locking mechanism for obtaining, holding, and releasing a lock on 

10 an individual data item may be implemented in accordance with the present invention. 
This implementation is best defined by the data source provider, by implementing 
such locking mechanism in the data source, itself. Ad hoc implementations for data 
sources that do not provide native locking may also be done via the DSIs. This 
mechanism enables DSIs to implement multiple changes atomically (as one 

15 transaction) by effecting those changes at the time of the release. In addition, a 
"rollback" feature for atomic changes is possible through the "revert" capability, 
which generally releases the lock without affecting the previous changes. This 
locking mechanism may also be leveraged to lock multiple objects simultaneously, at 
the discretion of the DSI, by associating the lock with a DSI-defined "lock object" 

20 which can either be associated with a single data item or with a group of data items, as 
appropriate. Using the DSI API, this provides to data consumers a single API for 
dealing with locking implementations. 

Figure 29 shows an embodiment of a "plug-in manager" called PluglnManager 
of the present invention. The programming framework embodied in this invention 

25 includes a "plug-in manager" which provides extensible communication between 
services and components within an application. Plug-ins are software modules that 
add a specific feature or service to a larger system (i.e., plug into a larger application 
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to provide functionality). For example, there are a number of plug-ins for the 
NETSCAPE NAVIGATOR browser that enables the browser to display different 
types of audio or video messages, e.g., SHOCKWAVE by MACROMEDIA. 

A "service" is capable of obtaining information on a data consumer or data 

5 source component and capable of using that information to provide specific facilities 
, to the application as a whole. Examples of such facilities include addition of entries 
to a top level application menu, loading MIME types into the global MIME type map, 
and running of scripts upon loading or unloading of data sources or consumers. The 
plug in manager loads new services at initialization and also at any time through an 

10 explicit request. The service in turn queries all modules present in the application as 
to whether they request any actions of the given service, executing them if so 
indicated. 

In more detail, as each new module, object, or component is loaded into the 
XIS framework, the PluglnManager 2905 on startup loads a special service called 

15 PluggableServiceFinder 2925, which searches for other services 291 5 and loads the 
services found into the PluglnManager 2920. The PluglnManager holds or keeps 
track of all services. These services are referred to as PluggableServices. As each 
pluggable service is loaded, the PluglnManager searches such service for defined 
resources and attaches these resources to the appropriate components or performs 

20 actions on resources found 2935. For example, a menu manager service might search 
for resources specifying menu entries and associated operations. A component that 
wants to add a menu entry to the global application menu bar would simply provide a 
resource of this type. In essence, as each new module is loaded, the PluglnManager 
tells the currently registered services ("PluggableServices") to look for new plug-ins. 

25 Thus, in essence the PluglnManager acts as a plug-in for plug-in handlers. 

The combination of the PluglnManager and the PluggableService interface 
allows communication between an XIS application and various XIS components. The 
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components may contain a number of resources that affect certain areas . of XIS. For 
example, they may have a resource file that contains an ECMA script. ECMA is an 
international industry association dedicated to the standardization of information and 
communication systems (see www.ecma.ch). If there is a PluggableService that 

5 knows about that resource file, then it may decide to run the ECMA script when it 
finds the. resource. The PluglnManager is responsible for. managing the resource list 
and all PluggableServices. When a new PluggableService is added, it is given all the 
resources to determine if it is interested in any of the resources on the list. If it is 
interested in a resource, then it may perform some action. 

10 In one embodiment of the invention, an ASCII file is created to indicate that a 

JAR file contains a resource to be provided to all PluggableServices. 

Table IX below shows an exemplary ASCII file that indicates that there are 
resources associated with the module containing the TableView class. It does not 
indicate what resources exist; it is up to the PluggableServices to determine if there is 

15 a resource in which they are interested. The PluglnManager, using Class.forNameO, 
creates the Table Vie w.class and calls the loadPlugln method on each of the 
PluggableServices. Below is the content of the loadPlugln method in the 
MimeTypesPluggableService : 



Table DC 

public static final String RES OURCEjNfAME = "leifResouixes/mime.types"; 
public void loadPlugIn(Class relativeClass) { 
if (loadedResources = null) { 
synchronized (this) { 
if (loadedResources = null) { 

loadedResources = new HashSetQ; 
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} 

} 

} 

try { 

String resource = PlugInManager.convertResourceName( 

relativeClass, RESOURCE_NAME); 
ClassLoader loader = relativeClass.getClassLoaderO; 
Enumeration enum = loader.getResources(resource); 
while (enum.hasMoreElementsO) { 

URL resourceURL = (URL)enum.nextElement(); 

if (resourceURL != null) { 

if (!loadedResources.contains(resourceURL)) { 
loadedResources.add(resourceURL); 

LeifJAFUtilities.addMimeTypes( 

baselnfoModel.getOwnedBeanContextChildO, resourceURL); 
} 

} 

} . 

} catch (IOException e) { 
e.printStackTraceO; 

} 

} 



The entire arrangement of data sources separated from consumers by a 
mediating structure, InfoModels providing context to Views, and a ViewHost and 
5 plug in manager playing set central organizing roles, allows a multi-purpose 
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application to be rapidly assembled out of preexisting components. Each available 
data source and consumer component may be integrated into the application by the 
plug in manager, and compartmentalization. 

Figure 30 shows a flow diagram of an embodiment of the invention that assists 
5 in creating XML (extensible markup language) DSIs and database DSIs. The XtS 
framework provides two sets of facilities for exposing electronically available 
' information that comes from data sources that are partly structured and/or self- 
describing, and for writing back possibly modified information to the sources. For 
example, one of these works for XML formatted data, and the other works for data 

10 stored in relational databases. However, the mechanisms are inherently extensible to 
any other data source that is partly structured and/or self-describing. 

The World Wide Web Consortium (W3C), which has standardized most of the 
XML formats to date, is in the process of defining a new XML format for declaring 
schemas, called XML Schema. The XML schema addresses the means for defining 

15 the structure, content, and semantics of XML documents. The present invention is 
configured to take into account future versions of the XML schema. 

In one embodiment, the present invention includes aspects of the method 
outlined below that are in common between the XML and relational database 
interfaces and can be applied in this general capacity to be part of the invention as 

20 well. In particular (described further below), an embodiment includes the apparatus 
involving separate processing of "data" (3002 branch) and "schema" (3004 branch) 
information, with a type conversion stage 3012 during the former and a metadata 
creation stage 3014 during the latter, followed by the construction of semantically 
enriched attributes 3016, 3018 based on the results of both these processes. 

25 In one embodiment, one method involves two apparatus or facilities designed 

to handle extensible markup language (XML) formatted data. An XML text stream 
comprises of a set of hierarchically structured "tags" interspersed with text "content". 
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The names, data types, and ordering of the tags may vary from stream to stream and is 
specified by a separate document called an "XML schema." A description of the 
XML schema is provided in the document "XML Schema Part 1: Structures (Working 
Draft)", which may be obtained from the W3C at the WWW address of 
http://www.w3.org/TR/xmlschema-l, and also in the document "XML Schema Part 2: 
Datatypes (Working Draft)", which may be obtained at the WWW address of 
http://www.w3.org/TR/xmlschema-2. Given an XML data stream, die first apparatus 
parses the XML schema appropriate for it and constructs metadata specifications 
appropriate for the contents of each tag. In some cases, these specifications are in the 
form of computer program segments that can be compiled into executable procedures 
that can be accessed immediately by a running application; in other cases, they refer 
directly to already precompiled procedures. The second apparatus parses the data 
document, matching the tags up with the types and metadata derived from the schema, 
and exposes the content in the standardized information representation using this 
metadata. This information includes the generic relational links described above in 
addition to attributes and metadata. 

In particular, the structures defined by an XML schema document determine 
the hierarchical and type structure allowed in XML instance documents, and this 
structure is paralleled again in the information elements (with attributes and member 
elements) constructed on parsing an instance. The following table (Table X) shows 
the correspondence: 
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Table X 


XML Schema 


Compliant XML 
Instance 


Resulting Information 
Element 


simple type outside attribute 
declaration 


element with no 
subelements 


(typed) attribute 


simple type inside attribute 
declaration 


attribute 


(typed) attribute 


complex type without 
descendents 


element with attributes 
but no subelements 


information element with 
attributes 


complex type with 
descendents 


element with 
subelements 


information element with 
member elements 



A complexType element, as defined in the W3C XML Schema standard, 
defines the structure of an information element. Elements contained within the 

5 complexType element which are defined as complexTypes themselves, are translated 
into the member elements of the information element defined by the containing 
complexType. All other elements and attributes contained within the complexType 
element, and defining single value types, are translated into attributes of the 
information element defined by the containing complexType. 

10 The XML ingestion process supports an additional capability that allows for 

the translation of types defined by an XML Schema, into more semantically rich 
domain policy based attributes that consumers in the present framework can take 
advantage of. To do this an embodiment of the present invention includes a process 
that uses XSLT (XML Stylesheet Language Transformations) to scan an XSDL 

15 (XML Schema Definition Language) document, and embed domain specific 

instructions in a new version of the XSDL document. The embedded instructions 
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direct the XML processing software to create information elements that contain the 
semantically richer domain attribute representations. In particular, the tags in the 
table below may be placed by the XSLT within <appinfo> subelements of elements in 
the XSDL schema document. When the schema parsing apparatus reads the resulting 

5 schema, it sets up the XML processor to perform the mappings as shown when 
reading an instance document. Because of the nature of the handling specified for 
<appinfo> elements in the XSDL specification (see the W3C Web site at 
http://ww.w3.org/XML/Schema), these will simply be ignored by other XML 
schema processors that have not been designed to read them. Table XI lists properties 

10 that may be used: 



Table XI 


Property 


Description 


domainfield 


A Domain Policy attribute to map instances of this XML element 
or attribute to 


typemetadata 


A metadata type to map instances of this XML element or 
attribute 


converter 


A type converter for transformation of XML data values (strings) 
into typed values such as floating point numbers or date objects 


visible 


The initial visibility state with which instances of this XML 
element or attribute should be exposed within an information 
element 


mutable 


Whether or not instances of this XML element or attribute can be 
edited after being exposed within an information element 
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Conversely, the system has the ability to construct an XML document and 
associated XML Schema from a hierarchy of information elements. The process for 
outputting an XML document and associated XML Schema from a hierarchy of 
information elements is essentially the reverse of the ingestion process. The resulting 
5 schema documents are generated with the special <appinfo> instructions that carry the 
additional semantic meaning for the attributes, but (see above) these additional 
instructions are embedded in a way that makes them transparent to other XML 
document readers that do not recognize them. In this way, an application-to- 
application information communication session can be set up using HTTP or a similar 

10 protocol for synchronous communications, and SMTP or similar for asynchronous 
communications. The sending application encodes information elements into an 
XML schema/instance pair using the just described apparatus and sends both to the 
receiver application. The receiver reconstructs the information elements also using 
the above apparatus. Thus, any form of structured, annotated information that can be 

15 expressed within our framework can be transmitted between applications using a 
simple document transfer protocol. Another embodiment of the present invention 
involves an apparatus 3020 , which will connect to a relational database system and 
extract or write information from it using the structured query language (SQL). The 
user of such an information source needs only to specify the tables and columns to 

20 access within the database, as well as any selection criteria to narrow the range of data 
returned. The apparatus performing this function will automatically convert the data 
in the database into the appropriate representational format and add metadata and 
parent-child links as required. In general, the process is similar to that described for 
the XML data input/output capability, except that SQL statements and conversion 

25 mappings specified by the user take the place of the XML schema and document type 
and hierarchy information. 
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The process translates the result of a database query into an XIS data item, and 
each row in the result set is translated into a member data item of the result data item. 
Each row data item can also have a database query associated with it which can be 
executed to provide its own member data item. Access to the member items is on- 
demand (e.g., as called for by a consumer), an operation we refer to as "drill-down". 

The row data items are created with attributes that are derived from the 
columns returned by the result set. The attribute specifications can be generated 
automatically from the result set column SQL type specifications (integer, date, text, 
etc.), or can be customized to suit the needs of the user. The customization process 
allows the user to map database result column type definitions into more semantically 
rich domain policy and/or metadata-enhanced attributes that consumers can take 
advantage of. In other words, the DSI can associate column data types with metadata 
types and domain policy attribute types. To do this the framework supports a number 
of attribute customization properties that the user can specify (described further 
below). 

Modifications to row data items are handled by allowing the user to associate 
parameterized update, insert and delete queries with a given result set. When the 
value of a record member attribute is changed, the user specified parameterized query 
is executed, and the parameters are filled in from the attribute values identified in the 
query specification. Insertion and deletion of record members are handled in a 
likewise manner. 

The following table, Table XII, describes the list of customizable properties 
supported by the SQL database interface process. These properties are used to 
describe a single interface to a database for producing one or more hierarchically 
organized information elements from its contents. 
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Table XII 


Property 


Description 


jdbc.driver 


JDBC vendor driver class name 


jdbc.url 


JDBC database connection URL 


display.name 


Default display name for result data item 


select query 


SQL select statement for result data item 


update .query 


Parameterized SQL update statement 


update.columns 


Result column names that fill update query parameters 


insert.query 


Parameterized SQL insert statement 


insert.columns 


Result column names that fill insert query parameters 


delete, query 


Parameterized SQL delete statement 


delete, columns 


Result column names that fill delete query parameters 


drilldown. query 


Parameterized SQL select statement for record drill- 
down 


drilldown. columns 


Result column names that fill drill-down query 
parameters 


result.attributes 


Result data item attribute names 


record.attributes 


Record data item attribute names 



The names of attributes listed for both result and record data items are used to 
uniquely identify the attributes. The customization of each attribute is done according 
5 to its unique name. The following table (Table XIII) describes the list of 

customizable properties that can be applied to each attribute, where <name> is the 
unique attribute name. Note the parallel between these properties and those given for 
the ! <appinfo>' tag insertion in the case above of XML data parsing. 
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Table XIII 


Property 


Description 


<name>.label 


The attribute display label 


<name>.domainfield 


A XIS Domain Policy class field to map this attribute 
to 


<name>.typemetadata 


A XIS metadata class name to map this attribute to 


<name>.converter 


A XIS type converter for transformation of result 
values 


<name>.columns 


The result columns names that will be converted 


<name> .visible 


The attribute initial visibility state 


<name>.mutable 


The editability of the attribute 



Given the metadata from known industry standard APIs (e.g., JDBC and . 
ODBC) that provide metadata for results (typically handled as tabular columns) 

5 including string, length, numeric precision, date formatting, etc, relational databases 
may have dynamic DSI toolkit built and implemented as shown in Figure 27. Tabular 
data may also be interpreted as a default string typed. Java objects, remote Java 
objects (via RMI or CORB A-derived interfaces), and Enterprise JavaBeans (a variant 
of RMI objects) may have DSIs automatically created for them, using, for example, 

10 reflection and known types (primitives and other typical types like String, Data, etc., 
and registered types). A developer may also place XlS-specific annotations (e.g., 
static AttributeDescriptor and FieldData methods) on reflected Java objects. 
Collection subclassed objects may also indicate containment. 

Dynamic data supplemental metadata may also be used in the XIS framework 

15 of the present invention. Schemas with little or no expressive information may also 
be used to specify additional metadata within the XIS framework, which include 
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mapping attributes to type metadata, mapping attributes or methods to domains, 
defining new attributes/methods based on existing data from the source, defining 
functions/user commands for easily implemented capabilities (e.g., deleting a data 
item, adding/inserting a new data item, initializing a template data item that a user can 
5 fill in before adding, etc.), and defining relationships to other data items to perform 
"drill-down" queries. Such type of schemas may be obtained, for example for Java 
Metadata API, CORB A API (on which the Java API was based), Oracle "common 
warehouse metamodel," and the like. Other formats for mapping metadata to schemas 
from other sources, or as might be defined in the future, may easily be incorporated 
10 within the framework. 

Distributed Application Capabilities 

In an embodiment, the application development framework being discussed 
offers three sets of facilities to aid in the development of distributed applications in 
which users, software application components, or both are distributed across multiple 
15 computers connected by a network. 

CORBA Exposure 

The first set of facilities allows the automatic exposure of a data source over a 
network to any remote consumer software object via the Common Object Request 
Broker Architecture (CORBA) protocol. This protocol allows the remote consumer to 
20 utilize information elements just as if they existed locally, but usually with lower 

bandwidth than it would take to send the entire elements over the network connection. 

To better understand the invention, examples are shown below in Table XIV, 
which shows an exemplary XML document. 



Table XIV . 


<tracks> 




<track name="FIRST"> 
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<country>US</country> 
<category>SUB</category> 
<threat>HOS</threat> 
<position> 

<lat>10.0</lat> 
<lon>10.0</lon> 
<alt>10.0</al£> 
</position> 
</track> 

<track name="SECOND"> 
<country>US</country> 
<category>AIR</category> 
<threat>FRI</threat> 
<position> 

<lat>20.0</lat> 
<lon>20.0</lon> 
<alt>20.0</alt> 
</position> 
</track> 
</tracks> 



The following table (Table XV) shows the result if the above XML document 
were run through an XML DSL 

5 

Table XV 

LEIF Data Item - tracks - 
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LEIF Data Item - track 




Attribute - name : String vaIue='FIRST' 




Attribute - country : String value='US' 




Attribute - category : String value='SUB' 




Attribute - threat : String value='HOS' 




LEIF Data Item - position : LEIF Data Item 




Attribute - lat : String value^lO.O' 




Attribute - Ion : String value='10.0' 




Attribute - alt : String value='10.0' 




LEIF Data Item - track 




Attribute - name : String value=' SECOND ' 




Attribute - country : String value='US' 




Attribute - category : String value=' AIR' 




Attribute - threat : String value='FRT 




LEIF Data Item - position 




Attribute - lat : String value='20.0' 




Attribute - Ion : String value='20.0' 




Attribute - alt : String value='20.0' 





Table XVI below shows an exemplary XSDL document. 



Table XVI 

<?xml version= M 1.0" encoding="UTF-8 M ?> 
<schema xmlns= M http://www.w3.org/l 999/XMLSchema"> 
<element name= : "tracks f, > 
<complexType> 

<element name-'track" type- Track" maxOccurs="unbounded7> 
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</complexType> 
</element> 

<complexType name="Track"> 

<attribute name^'name" type= ,, string , V> 
<element name= ,f country M type="string7> 
^lementname^'category" type="string M /> 
<elementname=="threat n type="string7> 
<element name="position" type=' f LatLonAlt7> 

</complexType> 

<complexType name= ,, LatLonAlt"> 
<element name="lat" type- 'decimal"/^ 
<element name= M lon" type= ,, decimal"A> 
<elementname= ,f alt n type= M decimarV> 
</complexType> 
</schema> 



XML Schema Definition Language (.xsd) documents are used to express the 
semantic descriptions of Attributes and the Domains in which they live. Code 

5 generation utilities as described above create the actual Domain Objects with their 
groups of related Attributes. Thus, developers may create new Domains, and add 
Attributes to their existing Domains, by modifying these XML Schema files and 
generating the appropriate Java code. XML Schema files include basic attribute 
constraints (e.g., value ranges, list of valid values, attribute naming, formatting, etc.) 

10 that are turned into TypeMetaData objects, as well as textual comments that are 

converted into Java documentation to define the intent of the attribute (or method, in 
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the case of Domain methods). In some cases, Java code is embedded in the document 
and used inline in the generated Java classes for the Domain. 

Table XVII below shows the result when the above XSDL document is used to 
type the elements in the XML document source. Note that the type for lat, Ion, and alt 
5 are now Double instead of String. 



Table XVII 

LEIF Data Item -tracks 
LEIF Data Item -track 
. Attribute - name : String value='FIRST 9 
Attribute - country : String value= 5 US 5 
Attribute - category : String value='SUB' 
Attribute - threat : String value='HOS' 
LEIF Data Item - position 

Attribute - lat : Double value='10.0 5 
Attribute - Ion : Double value= 5 1 0.0' 
Attribute - alt : Double valued 10.0' 
LEIF Data Item - track 

Attribute - name : String value- 5 SECOND' 
Attribute - country : String value^'US 5 
Attribute - category : String value=' AIR' 
Attribute - threat : String value=*FRT 
LEIF Data Item - position 

Attribute - lat : Double value='20.0' 
Attribute - Ion : Double value='20.0' 
Attribute - alt : Double value='20.0 5 
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The following table (Table XVIII) shows an exemplary XSLT document. 



Table XVIII 

<xsl:for-each select="xsd:element"> 
<xsl:choose> 

<xsl:when test= n @name= , position l,r > 
<xsl:copy> 

<xsl:apply-templates selects" @*"/> 
<annotation> 
<appinfo> 
<domainmap 

domamfield- f, com.xis.domains.geo.GeoDomain.latLonAlt M 

converter="DegreesToLatLonAltConverter" 

parameters- f lat,lon,alt" 

label="Position n 

/> 

</appinfo> 
</annotation> 
</xsl:copy> 
</xsl:when> 
<xsl:otherwise> 
<xsl:copy> 

<xsl:apply-templates select= u @*'7> 
</xsl:copy> 
</xsl:otherwise> 
</xsl:choose> 
</xsl:for-each> 
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When such a transformation is used with the previous XSDL source shown 
above, used to type the XML document source, the result is shown in Table XIX 
below. 



Table XK 

LEIF Data Item - tracks 
LEIF Data Item -track 

Attribute - name : String value='FIRST' 
Attribute - country : String value='US' 
Attribute - category : String value='SUB' 
Attribute - threat : String value='HOS' 
Attribute - position : LatLonAlt <- now mapped to 

GeoDomain.latLonAlt 
LEIF Data Item - track 

Attribute - name : attribute value='SECOND 5 
Attribute - country : String value='US 5 
Attribute - categoiy : String value=' AIR' 
Attribute - threat : String value='FRT 
Attribute - position : LatLonAlt <- now mapped to 

GeoDomain.latLonAlt 



Note that position has been mapped to GeoDomain.latLonAlt, meaning, it is 
now a LatLonAlt type. The lat, Ion, and alt attributes are still the same, but the 
position itself may now be dealt as a single LatLonAlt object rather than a generic 
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data item with three Double fields. The use of XSLT also enables the mapping of 
XML elements into TypeMetaData, such as the LatLonAltTypeMetaData in order 
have better manipulation of the data. 

In one embodiment of the invention, the XIS framework has a "remote" 
5 capability enabling referral to an XIS session, or the data within it, from a remote 
virtual machine. Primarily, this means that data retrieval and sharing is the basis for 
export and collaboration. Secondarily, it supports operating on data within XIS from 
a remote virtual machine, perhaps on information existing only at that remote virtual 
machine. 

10 In another embodiment, SOAP (Simple Object Access Protocol) may be 

utilized. SOAP is a messaging framework that defines a protocol for the exchange of 
information in a decentralized, distributed environment. See, for example, the W3C 
Web site at http://www.w3.org/TR/SOAP. SOAP provides an instantiation of the 
remote capability, and is used to enable a general-purpose means of mating together 

15 or communicating among distributed sessions. These sessions may be two full XIS 
sessions on separate servers, or may comprise one XIS server and one XIS client, or 
may be used to. interface XIS to otherwise very different software, even including 
software applications written in different programming languages and running on 
incompatible operating systems. All data and remote procedure calls are made 

20 through XML. Those skilled in the art will be understand that SOAP is an XML- 
based protocol. The working draft of this specification is currently being developed 
bytheW3C. 

In another embodiment, remote references are used. These references are 
persistable or persistent references to XIS data. In a distributed context XIS uses 
25 XML representations of the references to share, persist, or identify particular data. 
Embedded in the XML are custom information enabling determination of data 
location in files or databases, on web servers, or based on unique Ids or names within 
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the XIS session, or based on data which are passed to a constructor, or on an ECMA 

•i 

script that can re-generate the data object. . . 

In another embodiment, the data representation in the remote distributed 
sessions is all based on the XIS mediation layer. All data, regardless of the initial 
5 type, is passed and manipulated as sets of attributes and relationships. This greatly 
enhances portability and interoperability of the data. At the same time the data 
contains a global unique identifier, so the individual and specific source and identity 
of that data is maintained in spite of having been translated to a mediated format. 
In another embodiment, a metadata type, e.g., "Constructor Scripts," is used. 

10 This metadata type supports the generation of ECMA Script scripts to restore a 
TypeMetaData (metadata type) object at a later time. By executing the script, the 
TypeMetaData is restored to its exact state. The advantage over standard Java object 
serialization is control over the save/restore process, and the ability to represent the 
state in fairly readable text format. 

15 Distributed Multi-user Collaboration 

Figure 31 is a schematic diagram of the second set of facilities that allows 
users at remote computers to collaborate through shared views of the same data. It 
also shows objects and methods that may be involved in distributed collaboration 
facilities. Visual consumer components (e.g., INFOBEANs) are condensed and 

20 compressed so that they may be efficiently accessed by a remote computer and then 
locally displayed. This is done using a MetaView object, which encapsulates the 
essential elements of a visual component to allow reconstruction on another screen 
with minimum requirement for data transmission. MetaViews are manipulated using 
the relationship handling machinery of the framework as discussed above; in 

25 particular, an indirect reference to the MetaView is produced and passed around to 
remote consumers, who need only resolve the reference and retrieve the MetaView 
object if the user requests the display. 
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An event-handling schema is introduced for transmission of changes in the 
view from one computer to all others that are joined to the session. View 
management is accomplished via a "tree" display showing hierarchies of local views, 
sessions, and shared views (including properties and subsidiary data items). Views 

5 may be shared through the intuitive action of dragging and dropping them from one 
branch on the tree to another. Multicast protocols may be used so that MetaViews, 
LeifReferences (references), and Event objects may be transmitted directly from one 
computer to another without the need to go through a server. Alternatively, HTTP 
protocols may be employed if security and firewall considerations make multicasting 

10 impractical. 

Metadata Server Facilities 

Figure 32 shows a third set of facilities that allows remote consumer software 
objects 3220 to obtain additional annotations on information that is encountered along 
with at least a minimal self-description component, as may be found, e.g., in an XML 

15 tag name. These facilities are targeted to be useful to software agents 3202 in 

particular. (See Wooldridge, M., Jennings, N. (1995); "Intelligent Agents: Theory 
and Practice" in Knowledge Engineering Review 10:2.) For example, a Java software 
agent may occasionally encounter data objects or request terms, which were not 
anticipated when the agent was programmed. The tag name or other descriptive 

20 annotation (connector) 3206 is used as a key to request metadata and possibly domain 
policy methods defined within XIS from a known server, called a semantic repository 
3204. The server 3204 checks its index for a match; if a match is not found, it can 
optionally ask a predicate logic inference engine 320S to provide alternate names to 
search under (e.g., "cat, large, ferocious" is returned from the inference engine in 

25 response to a request for "lion"), which are then also compared to the index. If a 
match is found, the server returns the appropriate metadata and possibly domain 
policy method(s) to the requesting agent 3202, making use of either Sun's Jini 
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framework or Java's built-in provisions 3222 for network transfer and subsequent 
dynamic loading of classes (including, e.g., procedural components of the metadata 
and methods) to transfer the actual code procedures into the running agent. These 
transferred information can then be used by the agent 3202 to aid in handling the 
5 object. For example, an agent can display an unanticipated data type to a user by 

calling the renderer method thus returned from the semantic repository. The semantic 
repository may also interface with other repositories 3212 via a data network 3210, 
such as a wide area network (WAN) 3210. 

In the above embodiment, information metadata and even information access 
10 software may be dynamically downloaded from remote sources ("semantic 

repositories" or "Metadata Server Facilities"), e.g., from the data source itself or from 
an intermediary server. This is a unique feature particularly as applied to XIS 
metadata, domain policies, and DSIs. 

One skilled in the art will further understand that the common representation of 
15 and access to information from internal APIs (mediation layer) may be exported to 
distributed application in support of middleware architectures for scalability or other 
advantages, and in support of collaboration by sharing data and data changes 
(permanent or transient) with other distributed collaborators. 

The present invention also supports user "transfer" of objects from one context 
20 (e.g., between two INFOBEANs) via drag/drop, cut/paste, and other mechanisms. 
Transfers of objects apply only to non-contextual information. Thus, each view has 
its own InfoModel that provides the contextual information for that view alone. 
Example 5 below further explains this idea. 

Example 5 

25 The Example 5 application is contained in three Java source files, 

Hello World Java, HelloWorldTranslator.java, and TestHarness.java. The source files 
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for this Example are explained below. The resulting outputs are shown in Figures 
3 8 A and 3 8B . Non-contextual information is transferred in this Example. 

The Java source files in Example 5 modify those from Example 3 or 4 to 
demonstrate the use of drag and drop facilities within XIS, along with a more 
complex view. As before, changes from the previous step are marked by open and 
close commented braces. 

The table below (Table XX) shows a code snippet that replaces a portion of 
code in the HelloWorld.java file shown in Example 3. The code portion below 
replaces the portion of code 2102 found in Figure 21 to implement Example 5. 



Table XX 

/*{*/ 

private String myName; 
public HelloWorld(String myName) { 
this. myName = myName; 

} 

public String toStringO { 
return myName; 

} 

/*>*/ 



With the above modification, the HelloWorldjava file for this Example has 
been enhanced so that instances can be given names upon creation, and this name is 
returned by the toStringO method. Also, the getlDQ method has been removed. 
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The HelloWorldTranslator Java file for this Example is similar to the 
HelloWorldTranslator.java file shown in Figures 22A to 22C, except that this source 
file has been simplified from the previous version by removing the "course" attribute. 

Figures 37A to 37D list the TestHarness.java source file, where the bulk of the 
5 changes are coded. First of all, it contains an import to help lay out multiple 

components within a Jframe 3702, and also imports for two new XIS INFOBEANs: a 
Table bean and a Tree bean 3704. The tree bean displays data items and any member 
data items they contain, and enables users to select and perform various functions on 
them such as editing their properties. The table bean displays the attributes of 
10 multiple data items in a user-configurable way. 

The first portion of new code 3706A and 3706B initializes several HelloWorld 
objects and inserts them into an array. The table and plot INFOBEANs are initialized 
and placed side-by-side in a JFrame. They are not loaded with any data items, but 
items can be dragged onto them when the application is running. The next thing is 
15 that a tree INFOBEAN is initialized and loaded with the array, and it is put up in its 
own JFrame. 

This Example 5 application puts up two windows— the first is a Tree 
INFOBEAN containing several HelloWorld data items. The second has two frames, 
on the left a Table INFOBEAN, on the right a Chart INFOBEAN, both 1 of which are 

20 initially empty. The table is initially completely blank because it has no information 
on what headings are appropriate, while the plot displays a default grid. 

In the tree display, a user may select data items or open and close them, similar 
to the directory tree view provided by the "Windows Explorer" application. In this 
case, the only item that contains anything is the root, which is a special data item. 

25 Double-clicking on it opens or closes it, but it cannot itself be selected. Right clicking 
on an item (but not the root) brings up a menu of operations that may be performed on 
it. In particular, selecting 'Properties' brings up a property sheet window (as in the 
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previous examples) for that particular instance. A user may left-click-and-drag on 
data items from the property sheet window over to the table or the plot. 

The table automatically sets up columns for the preferred attributes of the data 
items dragged onto it. The layout may be changed interactively by either dragging on 
the headings or their boundaries, or by right clicking on the headings. Double 
clicking on the attributes enables a user to edit them. Items may also be dragged from 
the table onto the plot as well, or in the other direction. The selection and pen color 
attributes are kept aligned automatically between all views of the same data item. A 
user exits the application by closing the tree window. 

Data item commands, also known as JAF Commands (based on "JavaBeans 
Activation Framework") may also be implemented within XIS. The JAF API is a part 
of Java and provides a way to associate commands with object. By using JAF, 
developers may take advantage of standard Java interfaces to determine the type of an 
artitrary piece of data, encapsulate access to it, discover the operations available for it,: 
and to instantiate the appropriate bean to perform said operation(s). For example, if a 
browser obtained a JPEG image, JAF would enable the browser to identify that the 
stream of data is a JPEG image, and from that type, the browser could locate and 
instantiate an object that could manipulate, or view that image. JAF commands are 
typically used in pop-up menus' or menu bars to control objects. 

XIS uses JAF commands to control DSIs and perform operation on data items. 
Right clicking on a data item in an InfoBean pops up a menu with commands that are 
specific to that data item. JAF commands with XIS may implement the following: 

- "Context Menus" or pop-up menus initiated by right clicking on a 
display that represents one (or more) data items; 
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- Command "menus" may be combined into a menu for multiple objects 

(e.g., one single command (menu item) to delete all selected 
objects; 

- Addition of data item commands per object type by adding them to the 

"JAF" registry; 

- Addition of file/content MIME types in the display; 

- Addition to the "JAF" registry of entries that represent objects that can 

add any number of menu items dynamically; 

- JAF commands may be added by "Menu Populators" that can add 

- menu items for single and multiple data items; 

- JAF commands may be added by the environment for other typical 

functions that might be performed on any object (possibly 
depending on capabilities/content of that data item), e.g., 
Copy/Paste/Cut/Delete, Hide/Show, Refers To (if the object 
exposed relationships to other objects which may or may not be 
loaded yet), Contains, Referred by, Contained by, URLs 
(attributes), Properties, etc.; and 

- Default behavior of "Properties" command may be overridden using a 

"JAF entry." 

Figures 38A, 38B, 3SC, and 38D show how JAF is used within the framework. 
Figure 38A shows a menu of HelloWorld objects for selection, displayed on a screen 
of the computer system implementing the framework. Figure 3 SB shows that the 
HelloWorld objects are displayed through a graphing (data plot) viewer. Figure 38C 
shows the display of Figure 38B after the display cursor has been positioned over the 
bar graph, followed by a right-click. A context menu, enabling the user to select the 
"Properties" option, is displayed in Figure 38D. In this example, the HelloWorld 
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object can be manipulated by a PropertySheetlnfoBean object. Thus, selecting the 
"Properties" option results in a PropertySheetlnfoBean being instantiated showing the 
properties of the First HelloWorld object, as shown in Figure 38D. 

Another feature provided by the XIS framework is the use of attribute aliases. 
This enables one attribute from one domain to be substituted for an attribute in 
another domain. For illustration purposes, let us assume that we have two domains 
called Movement Domain and Physics Domain. The attribute speed in knots is 
defined in the Movement Domain, while the attribute velocity in meters/sec is defined 
in the Physics Domain. The XIS framework enables a developer to register or define 
that the speed attribute in the Movement Domain is similar or compatible with the 
velocity attribute in the Physics Domain. Thus, enabling a data consumer object to 
ask for the Attribute from the domain that it knows about, and have the value 
translated from the Attribute of the DSI from the second domain. 

Figure 39A, 39B, and 39C show details of an exemplary embodiment 
explaining how an interface for the attribute alias feature described above may be 
defined or implemented within the XIS framework. The illustration includes class 
listing for objects that are used in the preferred embodiment of the framework. 

Figure 40 is a block diagram of a computer that may be used to implement the 
framework described herein. The framework may be used in a single computer, or 
may be used in conjunction with one or more computers that may communicate with 
each other over a network to share data. Those skilled in the art wiU appreciate that 
the various data objects, framework extensions, and odier processes described above 
may be implemented with one or more computers, all of which may have a similar 
computer construction to that illstrated in Figure 40, or may have alternative 
constructions consistent with the capabilities described herein. 

Figure 40 shows an exemplary computer 4000 such as might comprise a 
computer in which an object oriented programming environment is supported to 
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permit the framework operations described above, and to permit the various display 
operations and computer processing events. Each computer 4000 operates under 
control of a central processor unit (CPU) 4002, such as a "Pentium" microprocessor 
and associated integrated circuit chips, available from Intel Corporation of Santa 
5 Clara, California, USA. A computer user can input commands and data from a 
keyboard and computer mouse 4004, and can view inputs and computer output at a 
display 4006. The display is typically a video monitor or flat panel display. The 
computer 4000 also includes a direct access storage device (DASD) 4008, such as a 
hard disk drive. The memory 4010 typically comprises volatile semiconductor 

10 random access memory (RAM). Each computer preferably includes a program 

product reader 4012 that accepts a program product storage device 4014, from which 
the program product reader can read data (and to which it can optionally write data). 
The program product reader can comprise, for example, a disk drive, and the program 
product storage device can comprise removable storage media such as a magnetic 

15 floppy disk, a CD-R disc, a CD-RW disc, or DVD disc. 

The computer 4000 can communicate with other computers over a computer 
network 4016 (such as the Internet or an intranet) through a network interface 4018 
that enables communication over a connection 4020 between the network 4016 and 
the computer 4000. The network interface 4018 typically comprises, for example, a 

20 Network Interface Card (NIC) or a modem that permits communications over a 
variety of networks. 

The CPU 4002 operates under control of programming steps that are 
temporarily stored in the memory 4010 of the computer 4000. When the 
programming steps are executed, the computer performs its functions. Thus, the 

25 programming steps implement the functionality of the event tracking process 
described above. The programming steps can be received from the DASD 4008, 
through the program product storage device 4014, or through the network connection 
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4020. The program product storage drive 401 2 can receive a program product 40 14, 
read programming steps recorded thereon, and transfer the programming steps into the 
memory 4010 for execution by the CPU 4002. As noted above, the program product 
storage device can comprise any one of multiple removable media having recorded 
5 computer-readable instructions, including magnetic floppy disks and CD-ROM 
storage discs. Other suitable program product storage devices can include magnetic 
tape and semiconductor memory chips. In this way, the processing steps necessary 
for operation in accordance with the invention can be embodied on a program 
product. 

10 Alternatively, the program steps can be received into the operating memory 

4010 over the network 4016. In the network method, the computer receives data 
including program steps into the memory 4010 through the network interface 4018 
after network communication has been established over the network connection 4020 
by well-known methods that will be understood by those skilled in the art without 

15 further explanation. The program steps are then executed by the CPU 4002 thereby 
comprising a computer process. 

It should be understood that the any device that supports the framework 
envirnonment described above, acting as a host computer, will typically have a 
construction similar to that shown in Figure 40, so that details described with respect 

20 to the Figure 40 computer 4000 will be understood to apply to all computers of any 
network system in which the framework or framework-developed applications are 
xitilized. Alternatively, the devices can have an alternative construction, so long as the 
computer can communicate with the other computers and can support the 
functionality described herein. 

25 All patents, patent applications, publications and references mentioned in the 

specification are indicative of the practice level of those skilled in the art to which the 
invention pertains. All patents, patent applications, publications and references are 
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herein incorporated by reference to the same extent as if each individual patent, patent 
application, publication or reference was specifically and individually indicated to be 
incorporated by reference. 

One skilled in the art should readily appreciate that the present invention is 
well adapted to carry out the objects and obtain the ends and advantages mentioned, 
as well as those inherent therein. The specific embodiments described herein as 
presently representative of preferred embodiments are exemplary and are not intended 
as limitations on the scope of the invention. Changes therein and other uses will 
occur to those skilled in the art which are encompassed within the spirit of the 
invention are defined by the scope of the claims. It will be readily apparent to one 
skilled in the art that modifications may be made to the invention disclosed herein 
without departing from the scope and spirit of the invention. 

The present invention has been described above in terms of presently preferred 
embodiments so that an understanding of the present invention can be conveyed. 
There are, however, many configurations for information system frameworks not 
specifically described herein but with which the present invention is applicable. The 
present invention should therefore not be seen as limited to the particular 
embodiments described herein, but rather, it should be understood that the present 
invention has wide applicability with respect to information systems generally. All 
modifications, variations, or equivalent arrangements and implementations that are 
within the scope of the attached claims should therefore be considered within the 
scope of the invention. 
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' CLAIMS 

We claim: 

5 

1 . An extensible framework for use in a computer system that supports an 
object oriented programming environment and includes a memory in which data 
objects can be stored, the framework comprising a set of object classes that can be 
extended using object oriented principles to define an information handling 

10 application with data objects comprising a class of data source objects and a class of 
data consumer objects, and a mediation layer that defines an interface between the 
data source objects and the data consumer objects to permit data communications 
between the two data object classes, such that the class configuration of the data 
source objects can be specified independently of the class configuration of the data 

15 consumer objects. 

2. A computer system that supports an object oriented programming 
environment and includes access to data storage containing specifications for a set of 
object classes that can be extended using object oriented principles to define an 

20 information handling application with data objects comprising a class of data source 
objects and a class of data consumer objects, and a mediation layer that defines an 
interface between the data source objects and the data consumer objects to permit data 
information exchange between the two data object classes, such that the class 
configuration of the data source objects can be specified independently of the class 

25 configuration of the data consumer objects. 
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* 3. A computer system as defined in claim 2, wherein the mediation layer 
defines a data interface that provides an information exchange standard between the 
data source objects and the data consumer objects. 

4. A computer system as defined in claim 3, wherein the data interface 
includes at least one attribute/metadata object class that specifies attributes, including 
metadata, and that provide declarative and procedural information relating to 
attributes in said data object. 

5. A computer system as defined in claim 3, wherein the data interface 
includes at least one Relationship object class that specifies relationships between 
data source class objects. 

6. A computer system as defined in claim 3, wherein the data interface 
includes at least one Domain Policy object class that specifies a group of related 
attributes, methods, and semantic information that indicates data processing to be 
available for the specified attributes, including the specific intent of said attributes. 

7. A computer system as defined in claim 3, wherein the data interface 
includes at least one Event Change object class that specifies change event 
registration for detecting changes in the data objects. 

8. A computer system as defined in claim 4, further including a 
TypeMetaData class of objects that specify semantic information indicating data 
processing to be available for specified attributes and intended use of the attributes of 
a data object. 
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9; A computer system as defined in claim 8, further including a TypelO 
class of objects that define a desired format of a data object attribute specified by a 
TypeMetaData class, 

10. A computer system as defined in claim 6, wherein an attribute alias may 
be specified by a user to indicate any data source attributes of an attribute domain that 
may be substituted with attributes of a different attribute domain. 

11. A computer system as defined in claim 4, wherein said 
attribute/metadata interface provides input/output functions for display and editing of 
the attribute during runtime. 

12. A computer system as defined in claim 4, further including a 
FieldMetaData attribute that specifies processing criteria for an attribute of a data 
object. 

13 . A computer system as defined in claim 4, wherein the processing 
criteria relates to a selected attribute of the data object for display processing. 

14. A computer system as defined in claim 5, wherein the indicated 
relationship may be resolved using a version of the Relationship object in cache of the 
computer system. 

15. A computer system as defined in claim 2, further including a 
collaboration facility that permits a user at a network computer remote from the 
computer system to share a view of a data object at the remote network computer. 



108 



WO 02/46916 



PCT/US01/48418 



16. A computer system as defined in claim 1 5, wherein the collaboration 
facility comprises a MetaView class of data objects that lightweight encapsulate 
elements of a data object for visual reconstruction on a display screen of the remote 
network computer. 

17. A computer system as defined in claim 4, wherein the data interface 
provides an override function that can override default metadata of the data object 
attributes. 

18. A computer system as defined in claim 6, wherein the data interface 
provides an override function that can override default metadata of the data object 
attributes. 

19. A computer system as defined in claim 3, wherein data objects provided 
through the data interface comprise information that specifies data attributes, 
relationships, event broadcasting of changes in all registered data consumer objects, 
metadata for attributes that provide declarative and procedural information and/or 
input/output functions for display and editing, and related data items, and wherein the 
data objects can store references without direct access to a related data item. 

20. A computer system as defined in claim 19, wherein the attributes and 
relationships include contextual metadata, and the events and methods are defined 
with respect to the contextual metadata. 

21. A computer system as defined in claim 3, wherein the mediation layer 
further includes object classes that include one or more methods that provide data 
exposure, and further including a Data Source Interface object class of data objects 
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with methods that automatically determine which data exposure method will be used 
for data communications between the data source objects and data consumer objects. 

22. A computer system as defined in claim 2 1 , wherein the determined data 
5 exposure method comprises data object reflection and introspection. 

23 . A computer system as defined in claim 2 1 , wherein the data exposure 
methods include a data source object method that provides a standard interface, a data 
source object and a Translator object that maps an alternate data interface to the 

10 standard interface, and a data source object that is inspected by the computer system 
to determine available data fields which are thereby exposed to data consumer objects 
by the standard interface. 

24. A computer system as defined in claim 3, wherein the data interface of 
15 the mediation layer provides a wrapper for the data objects. 

25. A computer system as defined in claim 24, wherein data exchange 
occurs without providing contextual data characteristics to a receiving data object. 

20 26. A computer system as defined in claim 25, wherein the contextual data 

characteristics are supplied by the data object wrapper. 

27. A computer system as defined in claim 3 3 wherein data exchange occurs 
without providing contextual data characteristics to a receiving data object. 

25 * 

28. A computer system as defined in claim 2, further including a plug-in 
manager object class that integrates service components into the application. 
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29. A computer system as defined in claim 28, wherein data service 
components interact with other components of the application to determine if a 
service is required and to determine parameters that are to be interchanged. 

5 

30. A computer system as defined in claim 29, wherein the service 
determination occurs upon introduction of newly loaded components. 

31. A computer system as defined in claim 3, further including a translator 
10 facility that translates information concerning a data object into (1) attributes and 

metadata that define groups of data source and data consumer class attributes and (2) 
an object class that specifies at least one domain method for defining groups of data 
object attributes. 

15 32. A computer system as defined in claim 24, further including an 

InfoModel data object class. 

33. A computer system as defined in claim 27, wherein said contextual data 
characteristics are supplied by an InfoModel object. 

20 

34. A computer system as defined in claim 33, wherein the InfoModel 
object receives a data source object for exposure to the data consumer objects, selects 
available attributes and methods of the received data source object for data 
characterization, and determines if the addition of attributes or methods to the data 

25 source object are appropriate. 
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35. A computer system as defined in claim 6, wherein the domain is defined 
using XML schema* 

36. A method of communicating data in a computer system that supports an 
object oriented programming environment and includes data storage or access to data 
storage containing data objects and specifications for a set of object classes that can 
be extended using object oriented principles to define an information handling 
application, the method comprising: 

receiving one or more data objects comprising a class of data source objects; 

representing the data source objects in accordance with an Information Model 
class of objects of a mediation layer that defines a data interface between the data 
source objects and a class of data consumer objects; 

wherein the Information Model objects include methods that permit data 
communications or information exchange between the two data object classes, such 
that the class configuration of the data source objects can be specified independently 
of the class configuration of the data consumer objects. 

37. A method as defined in claim 36, further including specifying at least 
one attribute/metadata object class that specifies attributes, including metadata, and 
that provides declarative and procedural information relating to attributes in said data 
object. 

38 A method as defined in claim 36, further including specifying a 
Relationship object class or classes that specify relationships between data source 
objects. 
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39. A method as defined in claim 36, further including specifying a Domain 
Policy or Domain object class or classes that specify a group of related attributes, 
methods, and semantic information that indicates data processing to be available for 
the specified attributes, including the specific intent of said attributes. 

40. A method as defined in claim 36, further including specifying an Event 
Change object class or classes that specify change event registration for detecting 
changes in the data objects. 

41. A method as defined in claim 3 7, further including specifying a 
TypeMetaData class of objects that specify semantic information indicating data 
processing to be available for specified attributes and intended use of the attributes of 
a data object. 

42. A method as defined in claim 41, further including specifying a TypelO 
class of objects that define a desired format of a data object attribute specified by a 
TypeMetaData class. 

43. A method as defined in claim 39, further including specifying an 
attribute alias by a user to indicate any data source attributes of an attribute domain 
that may be subtitued with attributes of a different attribute domain. 

44. A method as defined in claim 37, wherein the attribute/metadata 
interface provides input/output functions for display and editing of the attribute during 
runtime. 
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45. A method as defined in claim 37, wherein the attribute/metadata object 
class is a FieldMetaData attribute that specifies processing criteria for an attribute of a 
data object. 

46. A method as defined in claim 3 7, wherein the processing criteria relates 
to a selected attribute of the data object for display processing. 

47. A method as defined in claim 38, wherein the indicated relationship 
may be resolved using a version of the Relationship object in cache of the computer 
system. 

48. A method as defined in claim 36, further including providing a 
collaboration facility that permits a user at a nework computer remote from the 
computer system to share a view of a data object at the remote network computer. 

49. A method as defined in claim 48, wherein the collaboration facility 
comprises a MetaView class of data objects that lightweight encapsulate elements of a 
data object for visual reconstruction on a display screen of the remote network 
computer. 

50. A method as defined in claim 37, wherein the data interface provides an 
override function that can override default metadata of the data object attributes. 

51. A method as defined in claim 39, wherein the data interface provides an 
override function that can override default metadata of the data object attributes.* 
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52. A method as defined in claim 36, wherein data objects provided through 
the data interface comprise information that specifies data attributes, relationships, 
event broadcasting of changes in all registered data consumer objects, metadata for 
attributes that provide declarative and procedural information and/or input/output 

5 functions for display and editing, and related data items, and wherein the data objects 
can store references without direct access to a related data item. 

53. A method as defined in claim 52, wherein the attributes and 
relationships include contextual metadata, and the events and methods are defined 

1 0 with respect to the contextual metadata. 

54. A method as defined in claim 36, wherein the mediation layer further 
includes object classes that include one or more methods that provide data exposure, 
and further including a Data Source Interface object class of data objects with 

15 methods that automatically determine which data exposure method will be used for 
data communications between the data source objects and data consumer objects. 

55. A method as defined in claim 54, wherein the determined data exposure 
method comprises data object reflection and introspection. 

20 

56. A method as defined in claim 54, wherein the data exposure methods 
include a data source object method that provides a standard interface, a data source 
object and a Translator object that maps an alternate data interface to the standard 
interface, and a data source object that is inspected by the computer system to 

25 determine available data fields which are thereby exposed to data consumer objects by 
the standard interface. 
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57. A method as defined in claim 36, wherein the data interface of the 
mediation layer provides a wrapper for the data objects. 

58. A method as defined in claim 57, wherein data exchange occurs without 
5 providing contextual data characteristics to a receiving data object. 

59. A method as defined in claim 58, wherein the contextual data 
characteristics are supplied by the data object wrapper. 

10 60. A method as defined in claim 36, wherein data exchange occurs without 

providing contextual data characteristics to a receiving data object. 

61. A method as defined in claim 36, further including a plug-in manager 
object class that integrates service components into the application. 

15 • 

62. A method as defined in claim 61, wherein data service components 
interact with other components of the application to determine if a service is required 
and to determine parameters that are to be interchanged. 

20 63. A method as defined in claim 62, wherein the sendee determination 

occurs upon introduction of newly loaded components. 

64. A method as defined in claim 36 , further including a translator facility 
that translates information concerning a data object into (1) attributes and metadata 
25 that define groups of data source and data consumer class attributes and (2) an object 
class that specifies at least one domain method for defining groups of data object 
attributes. 
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65. A method as defined in claim 57, further including an InfoModel data 
object class. 

5 66. A method as defined in claim 60, wherein said contextual data 

characteristics are supplied by an InfoModel object. 

67. A method as defined in claim 66, wherein the InfoModel object receives 
a data source object for exposure to the data consumer objects, selects available 

10 attributes and methods of the received data source object for data characterization, 
and determines if the addition of attributes or methods to the data source object are 
appropriate. 

68. A method as defined in claim 39, wherein the domain is defined using 
15 XML schema. 

69. A computer system that supports an object oriented programming 
environment, the system comprising: . 

a processor that executes program instructions to provide the object oriented 
20 programming environment; and 

data store means for providing program instructions containing specifications 
for a set of object classes that can be extended using object oriented principles to 
define an information handling application with data objects comprising a class of 
data source objects and a class of data consumer objects, and a mediation layer that 
25 defines an interface between the data source objects and the data consumer objects to 
permit data information exchange between the two data object classes, such that the 
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class configuration of the data source objects can be specified independently of the 
class configuration of the data consumer objects. 

70. A computer system as defined in claim 69, wherein the mediation layer 
5 defines a data interface that provides an information exchange standard between the 

data source objects and the data consumer objects. 

71 . A computer system as defined in claim 70, wherein the data interface 
includes at least one attribute/metadata object class that specifies attributes, including 

10 metadata, and that provide declarative and procedural information relating to 
attributes in said data object. 

72. A computer system as defined in claim 70, wherein the data interface 
includes at least one Relationship object class that specifies relationships between 

15 data source class objects. 

73. A computer system as defined in claim 70, wherein the data interface 
includes at least one Domain Policy object class that specifies a group of related 
attributes, methods, and semantic information that indicates data processing to be 

20 available for the specified attributes, including the specific intent of said attributes. 

74. A computer system as defined in claim 70, wherein the data interface 
includes at least one Event Change object class that specifies change event 
registration for detecting changes in the data objects. 

25 

75 . A program product for use in a computer system that executes program 
instructions recorded in a computer-readable media to perform a method for 
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information exchange in a computer system that supports an object oriented 
programming environment and includes access to data storage containing data 
objects, the program product comprising: 

a recordable media; and 
5 a program product of computer-readable instructions executable by the 

computer system to perform a method comprising: 

receiving data specifications for a set of object classes that can be extended 
using object oriented principles to define an information handling application, 
wherein the extended objects provide an information handling application that can 
10 receive one or more data objects comprising a class of data source objects, and 
represent the data source objects in accordance with an Information Model class of 
objects of a mediation layer that defines a data interface between the data source 
objects and a class of data consumer objects; 

wherein the Information Model objects include methods that permit data 
15 communications or information exchange between the two data object classes, such 
that the class configuration of the data source objects can be specified independently 
of the class configuration of the data consumer objects. 

76. A program product as defined in claim 75, wherein the method further 
20 includes specifying at least one attribute/metadata object class that specifies attributes, 

including metadata, and that provides declarative and procedural information relating 
to attributes in said data object. 

77. A program product as defined in claim 75, wherein the method further 
25 includes specifying a Relationship object class or classes that specify relationships 

between data source objects. 
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78. A program product as defined in claim 75, wherein the method further 
includes specifying a Domain Policy or Domain object class or classes that specify a 
group of related attributes, methods, and semantic information that indicates data 
processing to be available for the specified attributes, including the specific intent of 
said attributes. 

79. A program product as defined in claim 75, further including specifying 
an Event Change object class or classes that specify change event registration for 
detecting changes in the data objects. 

80. A method of operating a computer system to execute an information 
handling application in an object oriented programming environment and to receive 
data from a class of data source objects and provide a class of data consumer objects 
with data, the method comprising: 

selecting available attributes and methods of a data source object for 
characterization; 

determining attributes or methods to be added to the data source object during 
application execution; and 

receiving the data source object and determining whether to expose or hide 
available attributes and methods of the object from data consumer objects, wherein 
data communications between the two data object classes is supported, such that the 
class configuration of the data source objects can be specified independently of the 
class configuration of the data consumer objects. 
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Figure 2 
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Figure 5 
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Figure 6A 
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Figure 6B 
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Figure 6C 
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Figure 7 
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Figure 9 
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Package com.xis. types 

This package contains classes that provide several standard TypeMetaData classes for describing types and their 
constraints, and for rendering and editing values of those types. 

See: . 

D escription 



Interface Summary 


QataTcst 


The DataTest interface specifies methods for Object validation. 


HTMLTvpelO 


This interface defines the 10 for HTML. 


Summary Function 


The Summary Fu net ion" interface defines generic summary functionality based upon provided 
input data values. 


SwingTypefO 


The SwingTypelO interface allows for the use of both swing editors, allowing swing 
components to edit an object, and swing Tenderers, which know how to render these objects in 
a swing environment. . 




The TextTypelO interface provides a means of formatting objects in a textual fashion, as well 
as parsing- text from which an object is created. 


Typed Value 


The TypedValue interface is used to hold an object that carries its own TypeMetaData with 
it. 


TvpeEditor 


The TypeEditor interface defines methods for editing attributes provided by the types 
implemented within this package. 


TypjzLQ 


The TypelO interface provides a common base from which other TypelOs can extend, such as 
HTMLTypel.O, SwingTypelO, etc. 


TypeMetaData 


The TypeMetaData interface defines generic type accessors for object comparing, editing, 
formatting.rendering; and validation. - 


Type^ietgDatqfac±ory 


The TypeMetaData Factory interface defines a class that can create TypeMetaData for a . 
given Class Type. ^ » 


TvoaRendcrer 


The TypeRenderer interface defines methods for rendering attributes provided by the types 
implemented within this package. 


ValidTestProxv 


The ValidTestProxy interface 


WMLTvpeEditnr 


The WMLTypeEdi tor interface defines methods for rendering attributes provided by the types 
implemented within this package. 




This interface defines the 10 for WML format. 


WMLTyfreReiiderer 


The WMLTypeRenderer interface defines methods for rendering attributes provided by the 
types implemented within this package. 


XJHLTypeJO 


The XMLType 10 interface provides a means of formatting objects in a XML textual fashion, as 
well as parsing XML text for creating an object. 



\r \0. 12 A 
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Class Summary 


AbstractDataTest ( 


rhe AbstractDataTest class provides a default implementation of test 
'Object) \ 


&bstracJIypdyietaPaJta 


UDs-tractTypeMetaData provides a partial implementation of 
rypeMetaData to relieve the XIS developer from explicitly implementing 
rrelevant methods. J 


A rea 0 fU n ce rta i n tyT^y_BelVletAQa ta 


^ceaOfUncertaintyTypeMetaData is a type object that supports 
AreaOfUncertainty objects. 


ArravListTvpeMetaPata 


ArrayListTypeMetaOata is a type object that supports 
/ova. utiLA rrayiist objects. 


Arrav l vpervieiauuta 


ArrayTypeMetaData is a type object that supports j ava. tang.reflect.Array 
objects. 


BeanTypeMetaPata 


BeanTypeMetaData is a type object that supports java.beans objects. j 


BooleanTvpcMctaPnta 


The BooleanTypeMetaData is a type object that supports Boolean objects, j 


BooleanTvpeMetaPataFactorv 


A BooleanTypeMetaDataFactory can create a 
BooleanTypeMetaData for given booleans. 


CaehedTvpeMetaPata 


CachedTypeKetaData is a type object that simply delegates all j 
TypeMetaData calls to another TypeMetaData. 




Classif icationTypeMetaData is a type object that supports 
Classification objects. I 


Lollecuons i ypeiYieiauata 


CollectionsTypeMetaData is a type object that supports Collection j 
objects. 


Colo rTvpeM eta Data 


The ColorTypeMetaData class implements TypeMetaData for Color 
objects. J 


£oi^Iil5ej^tapjiaJ^ct^y. 


A ColorTypeMetaDataFactory can create a ColorTypeMetaData for 
a given Color object. 


Co n v e rs to n N u m e ri cTyrjcM eta Pa ta 


A ^neric NumericTypeMetaData for converting from one unit to another. 


CurrenQ'Tjf'peMetaPata 


CurrencyTypeMetaData is a type object that supports Number objects 
that represent Currency values. 


PateTimeTypeMetaPata 


DateTimeTyoeMetaData is a type object mat supports uaie uujcwu*. 


P a_teT t m eTy peMe taPa taFjLcjary 


A DateTimeTypeMetaDataFactocy can create a 1 
DateTimeTypeMstaData for given Date objects. 


PiscreteRangeStringTy.p_eJ^taJlata 


m — .„iui«*- * ^ a ic a tvne nbiect that SUDDOrtS 1 
DiscreteRangeStringTypeMetaData is a rype oujc^l Lua^u HP 

String objects with discrete ranges. 1 


Pisp!avL^hPlT Y npMetaPata 


DisplayLabelTypeMetaData is a type object that supports supports j 
DisplayLabel objects. ' J 


PTCTypeMetaPata 


DTGTypeMetaData is a type object that supports Date objects. 


EnumerationTvpe 


Class to implement an enumeration in Java. 


F.niimpmrtnnTypelVletaPaia 


The EnumerationTypeMetaData class is used to represent mteger . 
constants as strings to the user. J 


FontTypeMetaPata 


FontTypeMetaData is a type object that supports Font objects. . . 1 


HashlWapTypeMetaPata 


HashMapTypeMetaData is a type object that supports j ava.uuLHashMap . 
objects. m — 1 
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HasliSetTvDeMetnDatii 


HashSetTypeMetaData is a type object that supports javQMtil.HashSet 
objects. 


1 CQjiSha pjTy ReJVle ta Data 


IconShapeTypeMetaData is a type object that supports IconShape 
objects. 


IconTyoeMetaData 


TrnnTvnpMph a Ha r a i< a fvnp ohip^ that cimnnrfc /r»n m nL! B r<ti< 
iLuiuy^ciJCi,GUGio id a \) ys: vjujwwi uiui juppurLo ICufl QOieClS- 


Li a ked Lis tTxpeiVl eta Data 


LinkedListTypeMetaData is a type object that supports ! 
java.util.LinkedList objects. 


ListTyaej^eta.Pata 


List TypeMetaData is a type object that supports java.util.List objects. 


Mous.eMapProxy. 


The MouseMap Proxy class allows TypeEditors access to the map without 
requiring them to having any compile time knowledge of the map's, 
existence. 


Clum^rCompaxator • 


An implementation of the Comparator interface that compares two objects 
that extend Number, or that both implement Comparable, with the class of 
one assignuDic uom me oiner. 


NumericTvpeMetaData 


NumericTypeMetaOata' is a type object that supports Number objects. 


numeric 1 ypeivietauatar actorv 


A NmnericTypeMetaDataFactory can create NuniericTypeMe ta Oat a 
for a given class type or method return type. 


> 

QJoj\«iIy.peJWeta^ata 


ObjectTypeMetaData is a type that supports a simple Object and is 
provided to quickly add arbitrary attribute types to a Data Source Interface 
without writing a more specific type handler. 


EercentTvoeMetaData 


PercentTypeMetaData is a type object that supports Number objects that 
represent Percent(%) values. 


Prnhn hNitvTvnpM am n»it«a 


ProbabilityTypeMetaData is a type object that supports Number 
objects that represent Probability values. 


B_en_ a m edType M et a Da ta 


RenamedTypeMetaOata simply delegates all TypeMetaData calls to 
another TypeMetaData except for the getNameQ, which is overridden widi 
the given value. 


R «izedjAxtTy^ 


ResizedTextTypeMetaData simply delegates all TypeMetaData calls to 
another TypeMetaData except for the getPixelWidthQ, which is overridden 
with the given value. 


Resources 


The Resources class is automatically generated and must be public, but it 
is intended to be used only by Java's internationalization support classes. 


§ jnartD u ra tio nTypeM eta Data 


A SmartDurationTypeMetaData for converting from one time unit to 
another based on the magnitude of the duration value. 


oir ' n .g.Lype iVle taL , ata . 


S t ringTypeMetaData is a type object that supports String objects. 


SirlngTyneMeta Da ta Fa cto ry 


A StringTypeMetaDataFactory can.create a StringTypeMetaData 
for a given String object. 


Tex tly peMetaData 


TextTypeMetaData is a type object that supports Text objects. 


IX9SA ValueTy peMeta JD aU 


TypedValueTypeMetaData is a type object that supports supports 
TypedValue objects. 


lYP_eE_ditorBeanContextChildSuppo rt 


The TypeEditorBeanContextChildSupport class handles most of the 
responsibilities of a TypeEditor and a BeanContextChild. 


TyoeEditorSuDport 


The TypeEditorSupport class handles most of the responsibilities of a 
TypeEditor. 


TvDerOPIugpableService 


The TypeIOPluggableServj.ce class is responsible for loading TypelOs. 




The Type IORegis try class is a registry for different implementations of 
Type 10 classes. 



f\G. .IfC 
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miiQ&uBuit • _ 


The Typeiosupport provides support for TypeMetaData'* getTypelO 
methods. _ . . 


IxpeJ^taCLataDeLegalor 


TypeMetaDataDelegator is a type object that simply delegates ail 
TypeMetaData calls to another TypeMetaData. 


TypeMetaDataFactoryjMuggabJeService 


The TypeMetaDataractoryPluggableService class is responsible for 
loading TypeMetaDataFactories. 


TvpeMetaDntaFactorvStore 


tl:. r\*e« e^nrpc TvneMetaDataFactories. 

i nis V— lass siurcs i /p&^ v l6 | ^ , -' a, • t * , •«■«■♦ ^ 


lypePreferences 


This class is used by TypeMetaData instances to pass .information about 
preferred TypeMetaData objects. 




The Types class is a holder class for the R£SOURCES global variable for 
resource properties of the com.xis.types package. 




URLTypeMetaOaca is a type object that supports URL objects. 



Exception Summary . - 


Nn.WhRnumerationExcep_tion 


Class to implement an enumeration exception in Java. 


ParseFailedException 


A ParseFailedException is thrown (typically by TypelO objects) when it is not. 
possible to parse a given String as desired. 


TestFniledException 


T^e TestFailedExcepcion is thrown from the "testQ" method of a DataTest 
subclass when the value fails the test. 



Package com.xis.types Description 

This package contains classes that "provide several standard TypeMetaData classes for describing types 
constraints, and for rendering and editing values of those types. 
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Figure 15 

HelloWorld.java 

/* XIS Tutorial standalone sequence example 1 data class. */ 

public class HelloWorld { 
private float value = 1 .5f; 

public String toString() { 
return "HelloWorld!"; 

} . 

public int getlD() { 
return 5; 

} 

public float getValue() { 
return value; 

} 

// uncomment this to make "value" editable 
/* 

public void setVa!ue(float value) { 
this.value = value; 

} 

*/ 
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Figure 16A 



TestHarness.java 

/* XiS Tutorial standalone sequence example 1 XIS interfacing. */ 
import javax.swing. JFrame; . 
import java.awtevent.WindowAdapter; 
import java.awtevent.WindowEvent; 

import com.xis.propertysheetPropertySheetlnfoBean; ^ 16Q2 
import com.xis.ui.UIBeanEvent; 
import com.xis.ui.UIBeanAdapter; 
import com.xis.leif.im.BaselnfoModel; 

public class TestHarness { 

public static void main(StringD args) { 

//the plugin manager is only required for more complex applications 
// involving multiple components integrated at runtime 
BaselnfoModeLsetStartingPluglnManager(false); 

// a property sheet infobean to display HelloWorld's attributes 
PropertySheetlnfoBean properties = new PropertySheetlnfoBean(); 
properties.addRawDataltem(new HelloWorldQ); 



1604 



1606 



// add listener for 'OK,' 'cancel/ or close, which generate 'close 1 events > 
properties.addUIBeanListener( 
new UIBeanAdapterQ { 

public void closed(UIBeanEvent event) { 
System. exit(0); * 



V 1608 



); 



} 



} 



// a top-level frame to hold our property sheet infobean 
JFrame frame = new JFrame("HelloWorld Properties");. 
// add a listener for window closing 
frame.addWindowListener( 
new WindowAdapter() { 

public void windowClosing(WindowEvent e) { 
System.exit(O); 

} 

} 

); 



r 1610A 
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Figure 16B 

Continuation of TestHarness.java 



// stick the bean in the frame and display it 

frame.getContentPane().add(properties); 

frame.pack(); 

frame.setVisible(true); 



> 1610B 
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Figure 1 8 A 



HelloWorld.java 



I* XIS Tutorial standalone sequence example 2 data class. 7 
/*{7 

import java.awt.Color; 

import java. beans. PropertyChangeSupport; 

import java.beans.PropertyChangeListener; 

n*i 

public class HelloWorld { 



private int value = 1; 

private Color myCoJor = Color.green; 



^ // this member class helps distribute property change events, within XIS 
private PropertyChangeSupport propertyChangeSupport = 
new PropertyChangeSupport(this); 

// two aux methods to let other XIS objects pay attention to this one 
public void addPropertyChangeListener(PropertyChangeListener I) { 
propertyChangeSupport.addPropertyChangeListener(l); 



. public void removePropertyChangeListener(PropertyChangeListener I) { 



propertyChangeSupport.removePropertyChangeListener(l); « 



/*{7 



"A 



} 




} 




1802 



public String toString() { 
return "A HelloWorld Object"; 

} 



public String getGreeting() { 
return "Hello World!"; 



public int getlD() { 
return 5; 

} 



J 
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Figure 18B 

Continuation of of HelloWorld.java 



public /T/int/T/getVaIue(){ 
return value; 

} 

/*{*/ 

public void setValue(int value) { 
// only update and fire property change if this is really a change 
if (this.value != value) { 
int oldValue = this.value; 
this.value = value; 

// fire property change event to notify other XIS objects . 7 > c m 

propertyChangeSupport .firePropertyChange( n value rt , oldValue, value); j > p 1 

} 

} 

public Color getMyCo!or(){ 
return myColor; 

} 

public void setMyColor(Co!or myColor) { 
// only update and fire property change if this is really a change 
if (this. myColor 1= myColor) { 
Color oldMyColor = this.myColor; 

this.myColor = myColor; » 
// fire property change event to notify other XIS objects | . ^ 



} 

\ } 
./*}*/ 

} 



propertyChangeSupport.firePropertyChangeC'myColor", 
oldMyColor, myColor); . J 
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Figure 19A 



TestHarness.java 

/* XIS Tutorial. standalone sequence step 2 XIS interfacing. */ 

import javax.swing. JFrame; 
import java.awt.event.WindowAdapter; 
import java.awt.event.WindowEvent; 
import com.xis.propertysheet.PropertySheetlnfoBean; 
import com.xis.ui.UIBeanEvent; 
import com.xis.ui.UIBeanAdapter; 
import com.xis.leif.im.BaselnfoModel; 
/*f7 

import jclass.chart.JCChart; 
import com.xis.plotPlotlnfoBean; 
import com.xis.plot.chartviews.LeifChartView; 
/*}*/ 

public class TestHarness { . 

public static void main(StringQ args) { *n 

// the plugin manager is only required for more complex applications 
// involving multiple components integrated at runtime 
BaselnfoModel.setStartingPluglnManager{false); 

HelloWorld hello = new HelloWorid(); 

// a property sheet infobean to display HelloWorld's attributes ^ 
PropertySheetlnfoBean properties = new PropertySheetlnfoBean(); 
properties.addRawDataltem(hello); 

// add a listener for 'OK 1 or 'cancel 1 , which generate 'close 1 events 
properties.addUIBeanListener( 
new UIBeanAdapterQ { 

public void closed(UIBeanEvent event) { 
System.exit(O); 

} 

} 

); 
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Figure 19B 

Continuation of TestHarness.java 



/*{*/ *\ 
// a top-level frame to hold our property sheet infobean 
J Frame propertySheetFrame = new JFramefHelloWorld Properties"); 
// add a listener for window closing 
propertySheetFrame.addWindowListener( 
new WindowAdapterQ { 

public void windowClosing(WindowEvent e) { 

System.exit(O); 
} • ' 

} 

); v . 

// stick the property Sheet bean in the frame and display it 
propertySheetFrame.getContentPane().add(properties); 
propertySheetFrame.pack(); 
propertySheetFrame.setVisible(true); 

// now we create a plot infobean to plot HelloWorld's numeric attribute 
I < PlotlnfoBean plot = new PiotlnfoBeanQ; 
1 plot.addRawDataltems(new ObjectQ { hello}); 
plot.setChartType(JCChart.BAR); ' 

//the alternatives are SCATTER^PLOT, PLOT, AREA, PIE, CANDLE, 
// and STACKING_BAR, though not all will make sense in this example 

i 

// a top-level frame as before to hold our property sheet infobean 
JFrame plotFrame = new JFrame("HelloWorId Plot"); 



/*}*/ 

} 



// stick the plot bean in and put it up 
plotFrame.getContentPane().add(plot); 
plotFrame. pack(); 
plotFrame.setVisible(true); 



J 
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Figure 20 
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Figure 21 

HelloWorld.java 

I* XIS Tutorial standalone sequence step 3 data class. */ 
import java.awt.Color; 

// (property change support moved to HelloWorldTranslator) 

public class HelloWorid { 
private int value = 1 ; 
private Color myColor = Color.green; 

public String toStringQ { 

return "A HelloWorid Object"; 

' } 

. public String getGreeting() { 
return "Hello World!"; 

} 

public int getlD() { 
return 5; 

} 

public int getValue() { 
return value; 

} 

./*{*/ 

public void setVaiue(int value) { 

// all the worrying about change events is moved to the translator, 
// so we just need to do the bare change operation (unless nonXIS 
// components need to listen to PropertyChanges) 
this.value = value; 

}- 
/*}*/ 

public Color getMyColor() { 
return myColor; 

y 

/*{*/ 

public void setMyColor(Color myColor) { 
// just need to set the value (see setValue()) 
this. myColor = myColor; 

} 

/*}*/ • 

} . 
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Figure 22A 



HelloWorldTranslator.java 

r XIS Tutorial standalone sequence step 3 data translator class. */ 
/*{*/ 

import com.xis.leif.im.AttributeGetRequest; 
' import com.xis.leif .im.AttributeSetRequest; 
import com.xisJeif.im. Domain; 
import com.xis.leif.im.Translator; 
import com.xis.leif.im.FieldMetaData; 
. import com.xis.domains.display.DisplayDomain; 
import com.xis.domains.movement.MovementDomain; 
import java.awt.Color, 

public class HelloWorldTranslator extends Translator { 

// the domains from which canned attribute metadata will be taken 
J // NOTE, if an attribute appears in the methods below but its domain 
<p? U \ // is NOT listed here, THE ATTRIBUTE WILL BE IGNORED BY XIS 
*" private static final DomainQ baseDomains = new DomainQ { 

DisplayDomain.getDomainO, MovementDomain.getDomain() 

}; 

- 1 77 store info about the fields, such as whether they are preferred or not 
l^ 0 ^ J private FieldMetaDataQ field MetaDataArray; 

// Return the Domains that describe the Attributes. 
0 ^ ) public DomainQ getBaseDomains() { 
& L return baseDomains;. 
} 

// this method returns info on each field defined in the methods below 
/ public FieldMetaDataQ getFieldMetaDataArray() { 

if (fieldMetaDataArray == null) { 

// initialize default metadata 
FieldMetaData dispname = new 

FieldMetaData(DisplayDomain.dispIayName); 

FieldMetaData pencolor = new 

FieldMetaData(DisplayDomain.penColor); 

FieldMetaData speed = new 

FieldMetaData(MovementDomain.speed); 

FieldMetaData course = new 

FieidMetaData(MovementDomain.course); 
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} 



Figure 22B 

Continuation of HelloWorldTranslatorjava 

// attributes are visible ('preferred') by default; this 
// turns this off for the course attribute 
course.setVisibilrty(false); 

// the order we put the attributes in here determines the order 
// they appear in tables or property sheets 
field MetaDataArray = new FieldMetaDataQ { ■ 
dispname, speed, course, pencolor 

}; 



} 



return fieidMetaDataArray; 



/////////////////™ 

// the following methods expose attributes of the HelloWorld class; 
// instead of calling the class methods directly, XIS will access 
// everything through this translator class 
llllllllllllllllllllllllillllllllllllllllllllllll^ 

public String getDisplayName(AttributeGetRequest attributeGetRequest) { 

return ((HelloWorld) 

attributeGetRequest.getRawDataltem()).toStringO; 

} , ■ " 

public Color getPenColor(AttributeGetRequest attributeGetRequest) { 
return ((HelloWorld) 

attributeGetRequest.getRawDataltem()).getMyColorO; 

} 

public void setPenColor(AttributeSetRequest attributeSetRequest, 
Color penColor) { 
HelloWorld helloWorld = (HelloWorld) ' " : 

attributeSetRequest.getRawDataltem(); 
Color oldPenColor = heiloWorld.getMyColor(); 
if (!penColor.equals(oldPenColor)) { 
helloWorld.setMyColor(penColor); 
// fire property change event to notify other XIS objects 
attributeSetRequest.getBaseDataltem().fireAttributeChanged( 
DisplayDomain.penColor, oldPenColor, penColor, true); 



} 



public double getSpeed(AttributeGetRequest attributeGetRequest) { 
return (double) ((HelloWorld) 

attributeGetRequest.getRawDataltem()).getValue(); 

} ' 
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Figure 22C 

Continuation of HelloWorldTranslator.java 

public void setSpeed(AttributeSetRequest attributeSetRequest, 
double speed) { 
HeiloWorld helloWorld = (HelloWorld) 

• attributeSetRequest.getRawDataltemO; 
* % < Double oldSpeed = new Double((double)helloWorld.getVaiue()); 1 
V \ if (oldSpeed.doubleValueO != speed) { I 
1 . helloWorld.setValue((int)speed); m " ' 

// fire property change event to notify other XIS objects 
attributeSetRequest.getBaseDataltem().fireAttributeChanged( 
MovementDomain.speed, oldSpeed, new Double(speed), true); 

} 

// this is a dummy attribute to demonstrate field metadata ( q~L,o g, 

public double getCourse(AttributeGetRequest attributeGetRequest) { s 
return (double) 0; 

} 

/*{*/ 

// uncomment this to allow reflection to expose additional attributes 
// ( se e documentation under "Fooling Around") 
// public HelloWorldTranslatorQ { 
// introspectExcept(new StringD {"value", "myColor"}); 

} 

n*i 
} 
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Figure 23A 

TestHarness.java 

/* XIS Tutorial standalone sequence step 3 XIS interfacing. */ 

• import javax.swing.JFrame; 
import java.awtevent.WindowAdapter; 
import java.awt.event.WindowEvent; • 
import com.xis.propertysheet.PropertySheetlnfoBean; 
import com.xis.ui.UIBeanEvent; 
import com.xis.ui.UIBeanAdapter; 
import com.xis.leif.im.BaselnfoModel; 
import jclass.chartJCChart; 
import com.xts.plotPlotlnfoBean; 
import com.xis.plot.chartviews.LeifChartView; 
/*{*/ 

import com.xis.leif.im.TranslatorRegistry; 
import com.xis.Ieif.im.LeifDataltem; 
import com.xis.leif.im.lnfoModel; 
import com.xis.lejf.im.BaselnfoModel; 
import com.xis.domains.movement.MovementDomain; 
import com.xis.domains.movementMovementDomainWrapper; 
import com.xis.Ieif.im.LeifDataltemDelegator; 
import java.lang. reflect. InvocationTargetExceptiop; 
import com.xis.leif.im.UndefinedLeifAttributeException; 

/*)*/ 

public class TestHarness { 
/*{*/ 

protected static LeifDataltem leifHello; 
static { 

// Register the translator for HelloWorld. In fact this is really 
// only necessary when we have not followed the standard naming 
// convention (see docs), but it can't hurt. 

TransIatorRegistry.getTranslatorRegistry().register0.bjectSchema( 
HeNoWorld.class, HelioWorldTranslator.class); 

} 

/*}*/ 

public static void main(StringQ args) { 

// the plugin manager is only required for more complex applications 
// involving multiple components integrated at runtime 
BaselnfoModeLsetStartingPluglnManager(false); 

HelloWorld hello = new HelloWorldQ; 
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Figure 23B 

Continuation of TestHarness.java 

// a property sheet infobean to display HelloWorld's attributes 
PropertySheetlnfoBean properties = new PropertySheet!nfoBean(); 
properties.addRawDataltem(hello); 

// add a listener for 'OK' or 'cancel 1 , which generate 'close 1 events 
properties.addUIBeanListener( 
new UIBeanAdapterQ { 
public void closed(UIBeanEvent event) { 
System. exit(0); 

} 

} 

); 

// a top-level frame to hold our property sheet infobean 
JFrame propertySheetFrame = new JFrame("HelloWorld Properties"); 
// add a listener for window closing 
propertySheetFrame.addWindowListener( 
new WindowAdapter() { 

public void windowClosing(WindowEvent e) { 
System. exit(0); 

} 

} 

); 

// stick the property Sheet bean in the frame and display it 
propertySheetFrame.getContentPane().add(properties); • 
propertySheetFrame. pack{); 
propertySheetFrame. setVisible(true); 
// now we create a plot infobean to plot HelloWorld's numeric attribute 
PlotlnfoBean plot = new PlotlnfoBean(); 
plot.addRawDataltems(new ObjectQ { hello }); 
plotsetChartType(JCChartBAR); 

// the alternatives are SCATTER^PLOT, PLOT, AREA, PIE, CANDLE, 
// and STACKING_BAR, though not all will make sense in this example 

// We can set the attribute for initial display on the plot; 
// if we do, this must consist of the attribute name preceded 
// by the fully-qualified classname which ORIGINALLY DEFINES 
// the attributeDescriptor - i.e., using "HelloWorld.speed" 
// here will NOT work! If the descriptor is not defined in a 
// domain or translator class, then it will have been defined 
// dynamically through introspection when the first instance 
// of the data item is dropped into an XIS InfoBean. 
plot.setYAxisAttribute( 
"com.xis.domains.movement.MovementDomain. speed"); 
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Figure 23C 

Continuation of TestHarness.java 

plot.setDynamicAdjustment(true); // so axes track value magnitude 
plot.setBarChartAdjusting(true); // needed in some cases for bar chart 

// a top-level frame as before to hold our plot infobean 
JFrame plotFrame = new JFrame("HelloWorld Plot"); 

// stick the plot bean in and put it up 
plotFrame.getContentPane().add(plot); 
plotFrame.pack(); 
plotFrame.setVisible(true); 

// create a leifDataltem version of hello and start a thread that 
// will increase it 
leifHello = 

BaselnfoModel.getBaselnfoModel().getLeifDataltem(hello); 
new Accelerate(); 

/*}*/ 
}//main 

} 

/*{*/ 

// thread to update the speed attribute on the leifHello instance we created 
class Accelerate extends Thread { 

public Accelerate() { 

super(" Accelerator Thread"); 
. startQ; 
} 

public void run() { 

//wrap the LeifDataltem leifHello in a convenience wrapper that 
// gives access to attributes within that domain, if they exist 
MovementDomainWrapper helloMovementWrapper = 
MovementDomain.takeWrapper(TestHarness.leifHello); 
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Figure 23D 

Continuation of Test Harness.] ava 



while (true) { 

// sleep for 0.5 seconds, then... 
try{ 

sleep(500); 
} catch (InterruptedException e) { 

System.exit(l); 

}' 

// ..update the speed attribute 
try{ 

helloMovementWrapper.setSpeed( 

helloMovementWrapper.getSpeed()+1); 

} catch (Undefined LeifAttributeException ulae) { 

// exception if this data item doesn't have this attribute 
System.exit(l); // usually we would do something better 

} catch (InvocationTargetException ite) { 

// sweep up any exception tossed by the underlying raw item 
System.exit(l); // usually we would do something better 

}// while 
}//run() 
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Figure 24A 
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Figure 25A 

HelloWorld.java 

/* XIS Tutorial standalone sequence step 4 data class. */ 



import java. 
/*{*/ 

import com 
import com 
import com 
import com. 
import com 
import com. 
import com. 
import java. 
import java. 
/*}*/ 



a wt Color; 

xis.leif.im.FieldMetaData; 

xis.domains.display.DisplayDomain; 

xis.domains.movement.MovementDomain; 

xis.leifJm.Domain; 

xis.Ieif.im.AttributeGetRequest; 

xis.leif.im.AttributeSetRequest; 

xis.leifjm.AttributeDescriptor; 

beans.PropertyChangeSupport; 

beans.PropertyChangeListener; 



public class HelloWorld { 

private int value = 1 ; 

private Color myColor = Color.green; 

/t/ n 

public static Attribute Descriptor getDispiayNameDescriptorQ { I 

return DisplayDomain.displayName; I ~L£OlL 

public static AttributeDescriptor getSpeedDescriptor() { 
return MovementDomain.speed; 

} 

public static AttributeDescriptor getPenColorDescriptor() { 
return DisplayDomain.penColor; 

} 

i*yi 



/*{*/ // this property change support code as in step 2 /*}*/ ' 
// this member class helps distribute property change events within XIS 
private PropertyChangeSupport propertyChangeSupport = 
new PropertyChangeSupport(this); 



// two aux methods to let other XIS objects pay attention to this one- 
public void addPropertyChangeListener(PropertyChangeListener I) { 
propertyChangeSupport.addPropertyChangeListener(l); • 

public void removePropertyChangeListener(PropertyChangeListener I) { 
propertyChangeSupport.removePropertyChangeListener(l); 



J 
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Figure 25B 

Continuation of HelloWorld.java 

public String toStringO { 

return "A HelloWorld Object"; 

} 

public String getGreetingQ { 
return "Hello World!"; 

} 

public int getlD() { 
return 5; 

} 

public int getValue() { 
return value; 

> 

/*{*/ // this function as in step 2 /■}*/ 
public void setValue(int value) { 
// we only want to update and fire property change if really changes 
if (this. value != value) { 
int oldValue = this.value; 
this.value = value; 

// fire property change event to notify other XIS objects 
propertyChangeSupport.firePropertyChange("value" f oldValue, value); 

} 

} 

/*{*/ 

// "myColor"-related methods changed to expose "penCoIor" instead 

public Color getPenColor() { 
return myColor; 

} . 

public void setPenColor(Coior penCoIor) { 
// we only want to update and fire property change if really changes 
if (penCoIor != this.myColor) { 
Color oldPenColor = this.myColor; 
this.myColor = penCoIor; 

// fire property change event to notify other XIS objects 
propertyChangeSupport.firePropertyChange("penColor", 

oldPenColor, penCoIor); 

} 

} 
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Figure 25C 

Continuation of HelloWorld.java 

// expose toString() return under a new name 
public String getDisplayName() { 
return toString(); 

} 

// expose "value" under a new name 
public double getSpeed() { 
return (double) getValue(); 

} 

public void setSpeed(double speed) { 

• // we only want to update and fire property change if really changes 
Double oldSpeed = new Double((double)this.getValue()); 
if (speed != oldSpeed.doubleValue()) { 
setValue((int)speed); 

// fire property change event to notify other XIS objects 
propertyChangeSupport.firePropertyChange("speed", oldSpeed, 

new Double(speed)); 

} 

} 

ryi 



./*{*/ 



// store info about the fields, such as whether they are preferred or not^) 
private static FieldMetaDataQ fieldMetaDataArray; 

// this method returns info on each field defined in the methods below 
public static FieldMetaDataQ getFieldMetaDataArray() { 

if (fieldMetaDataArray == null) { 
// initialize default metadata 
FieldMetaData dispname = new 

FieldMetaData(DisplayDomain.displayName); 
FieldMetaData pencolor = new 

Field MetaData(DisplayDomain.penColor); 
FieldMetaData speed = new 

FieldMetaData(MovementDomain.speed); 
// could customize the field metadata here 
fieldMetaDataArray = new FieldMetaDataQ { 
dispname, speed, pencolor 



} 

ryi 
} 



}; 
} 

return fieldMetaDataArray; 



J 
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Figure 26 
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Figure 27B 
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Figure 30 
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Class ContentlnfoB.ean . 

iava -.lanjg^Pbiect 

I . . 

+ — i ava_. awt . Component ' 

I 

+ — jj^y^a^ aw t^oji twiner • 

• I • - * * 

+ — j avax . s wing . JC om oonent 

■4*--javax . swing . JPanel 

1 ■ ' ■• ■ 

f — com. xis . ui . AbstractUIBean 

• I 

+ — com.xi s . leif_..in£obean3 . DataltemS i nkUIBean ' 
I 

+--coa . xis . infobeans . content . Con tentlnfoBean 

All Implemented Interfaces: 

Accessible . BeanContextChildQwner . BeanContextChiidOwnerDelegator . BeanContextProxv . 
BeanContextServicesQwn er Delega tof. Cli pboardUser. DataltemSink . ImageObserver T MenuContainer, 
Serializable . StateSavable . LHBean 



public class ContentlnlbBean 
extends DataltemSinkUIBean 

implements Cli pboardUser ' 

The CpntentlnfoBean class is a visual component that displays the contents of a raw data item. If no contents are 
available, it defaults to a split pane 'containing the JAF menu and the PropertySheet of the raw data item. The contents 
may have be multipart, and may be text, html, rich text, or an image. Multimedia support will soon be added. 

Author: 

Jaime Garcia,- Polexis, Inc. 
See Also: 

Serialized Form 



Inner classes inherited from class javax.s\ving.JPa_neJ 



JPanel .Accessible JPanel 



Inner classes inherited from class javax.swing.JCom ponent 



? JComoonent 



Inner classes inherited from class java.awt.Cmrtajner 



Container. Accessible AWTContainer 
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Inner classes inherited from class iava.awt. Coroponent 
Component. Acces3ib leAWTConoonent 



Field Summary 


static "m»3*J S.^XS.^a.i; &dl a 


RESOURCES 




localized resources for this view object. 



Fields inherited from class com.xis.ui.AbstractUlBean 
uibeanListener 



Fields inherited from class javpx.swing. ^Component 

accjtg s iblaCont ext: , LiatgnerLiat , TOOL_TIP_T£XTJC£r . u±, UN0 EFINED_CONDITI0N , 
WH5M_ WCESTQR M QF^ gpCUSEp^CQMPQNS^T. WHEN_r OCUS ED, WHSN JC^FOCUSE D_W IN DOW ' 



Fields inherited from class java.awt.£omppn enj 

SpJXQj^UXGNM^NX, ^lE^AjJGjjHENI, i&n^kklGmimi, RIGHT_ALIGMtt£NT, TOP^AI^GNi^ENI ' 



Fields inherited from interface iava.awt.image. ImapeQbserver 

ABORT , ALLBITS, 2RROR , FRAKEBITS , HEIGHT , PROPERTIES ', 5QMEBIT5 . WIDTH 



Constructor Summary 

Cpatearlaf aBean ( ) 

Default constructor that creates an empty ContentlnfoBean. 

• * i 



Method Summary 


. void 


a ddRay Data Item ( Obi set rawDa taltem) 

Load the raw data item into the ContentlnfoBean. 


void 


addRavDatal terns (Object 1 1 tawDatal terns ) 

Add the raw data items in the array. , 


boolean 


caaClearO 

Return true if the ContentlnfoBean has an object and it is selected 


boclean 


canClear (Obiect [•] items) 

Return true if the specified items can be cleared. 


boolean 


canCopy ( ) • 

Return true if the ContentlnfoBean has en object and it is selected 


boolean 


canCoEz(Qfejeci( 1 items) 

Return true if the specified items can be copied. 


boolean 


canCut ( ) 

Return true if the ContentlnfoBean has an object and it is selected 


boolean 


canCut (Object f 1 items) 

Return true if the specified items can be cut. 


boolean 


canPaste ( J 

• Return true if the CantemlnfoBean can'paste new obj ects, false if not. 


boolean 


canSQloctAllO 

Return true if the ContentlnfoBean can select all objects. 



WO02/46916 



52/90 



PCT/US01/48418 



boolean 


canSelectttcne { ) 

Return true if (he Contend nfo Bean can un-select ail objects. 


.void 


clear () 

Notify the Contentlnfo3ean to remove the current raw data item only if it is selected. 


VOW 


clear (Cb-iect ( 1 items) 
Clears the given items. 


void 


c^aarAlJ, ( ) 

Removes the currently loaded object. 


boolean 


contains (Obi ect U items) 

Return true if this ContentlnfoBean contains all the obj ects of the given array. 


boolean 


cq n tain sCompo ne n. t ( Cornpc n a n t component) 

Check if thr given component is contained by this InfoBean 


void 


copy [Clipboard clipboard) ' 

Ldlleu to invoice tnis moment in too "an 5 copy action, wtm.ii u iu v.upy an acicuicu udia 
to the Ciioboard. 


void 


espy (Cll p c c a c Q ci ipocara, ycTecjtu- items! 
Cosies the given items into the Clipboard. 


. protacteC void 


sreate-ontentU 

MetnoG caiicu wnen mere is no curucni iu uiapmy iui a taw uhlh ucm. 


voic 


cut (Ciioboard clipboard) 

Cut selected items trom ine L-ontcnunrooean ana posv-tnem uuo uupoouru. , 


void 


cuttCLLoboard ciioboard, Object H items) 

Cut the given- items from the ContentlnfoBean and post them* into the given Clipboard . 
only if they occur in the ContentlnfoBean. 


pro£ a ct&d ■ Con ^ ft in 5 r 


getCgn calnerFc rC a n ten t ( in t index) 

Get a container with the contents of the content object at the given index, or null if the 
content type is not supported. 




geiCpnianta () 

Fetch the currectly loaded raw data item 




c e t JATAnd? rooer tyC amonen t ( ) 




Get the JAFAndProperty component used by the ContentlnfoBean to display the 
contents for raw data items that have nothing else to display. , 


JMgflU 


S f.tL«ifnaralte3iMenu t Leif Datalt em cataltem, boolean ahcwCut Pastel teiw ) 
Return the data item menu for a LeifDataltcm (usually the selected LeifDataltem). - 




qet3.es purees ( 1 

Return the Resource3undle for this ContentlnfoBean. 


Object H 


ge_tSe.IectBdQbjec-a ( ) . 

Get an array of selected objects. 


void 


inf oMpdelChanged ( ) . . 

Messaged to indicate an infoModel change for this LnfoBean or one or more of its 
LeifDataliems. 


boolean 


isCreatingContent C ). 

Check whether default content creation is set 


boolean 


isDragSnabiad ( ) 

Return true if the default Drag support is enabled. 


boolean 


iaPropEnahledO 

Return true if the default Drop support is enabled. 
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boolean 


isSelec ted ( ) 

Check the selected state of the content object, if there is currently one loaded. 


boolean 


isXISNotifying( ) 

Check whether the ContemlnfoBean' is updating based on XIS events and is notifying 
XIS of raw data item attribute changes • 3 


void 


paste (Clipboard clipboard) 

Paste the data Objects from the given cl ipboard,- 


void 


rexnovaAllRawDatalteias () 

Remove all of the raw data items that are currently loaded 


• • void 


.ceroavaRawD aba Item (Object rawQatal tem) 

Remove the given raw data item if it is the currently loaded raw data item 


void 


'ramovoRawDatalzaxs (Obi set { ] rawData Irens ) 
Remove the raw data items in the array. 


void 


seleotAll () • 
Set the selection state of the object to true. 


void 


selectNone() 

Set the selection state of the object to false. 


void 


setCreateCpntent (boolean create) ' 

Set whether content should be created for objects that do not have any displayable 
content, via a JAFAndPropertyComponent. 


void 


s etDragSnabled (boolean enabledrag) 
' Set the status of the default Drag support. 


void 


se tDraqOwner Proxy (PraoOwner dragProxy) 
Set a DragOwner "proxy" for this InfpBean. 


void 


se tDrop2nabled( boo lean enabledroo) 
Set the status of the default Drop support. 


•void 


satDropOwnerProxvfDrooOwner drcpProxy) . 
Set a DropOwner "proxy" for this InfoBean. 


' void 


aetSeiection (boolean selected) 

Set the selection state of the content object ' 


void 


satXISNptifyingl boo lean notify) 

Set whether the ContentlnfoBean should update based bn XIS events and should notify 
XIS of raw data item attribute changes 



Methods inherited from class co m. xts. lei f.info beans. Data IremS in kLTlBean 



add Ah? P opu 1 a t o r f addRawDataltsmaAsGrou p, addServic e, close .. 
createB'eanContextServicesO vnerDglec ator. dispose , o etBeanC o ntextProx y . 
g_e_tBeanContextServices . g_e tZzCorit s x t . getlnfoModel . cet JAFPopulatocs . 
qetLeif D atal temMenu . getLei £D a tal tern rtenu , qetLei. f Da t a I temMenu . qe tMenuSar , 

qetOwnedBeanContextChUd;. getService, getService, get;Service, 

SfitUll, iBi.tMlizeBeanContex^flespurcQ^, initializeBeanConta xtSarvlcas , 
Invalldatelnfo^pdpl . isDro pPas-eEnabls d, isHandlinoCl IoboarriOpera-lon^ . 
•releaje , BeanCQriLgMRe50Urce a. relea5figeaQCanLe^nSet^^C£5> revokeAnchoredDialooProvidar. 
revokeFraroeProvldgr., xgv.Q)cQ 5e rvj.es , ssiQifl 
yaU^a.te^ad.incSetBeanCo.n^juix 



Met hod i inherited from class com.xis.uLAbstractUIBenn, 



addD^?AnLj^££CJJ> £iA&li5L&, Qe tShortTi tle. qetTitlg, cetUICompongnr. 5 . isActive , 
I SClog^d , A^Lic^piS, PXQCS3^p?:Beanfive.nt < rarnoy^PLBjianL^tenax, r,agto,re,5t;a£e, sayeState , 
.set^iy^, 5£t5hQCCTitle, setTitle 
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Methods inherited from class javax.swing. JPanel 

qetAcces s LbleContext , ae tOrClassID . paramStrino , uodateUI 



Methods inherited from class javajcswing. JComponent 

addAncgst orListaner , addMotify . addProoertvChanaeLiataner. acdPropert yChanqeLls tener , 
addVetoableChanaeListener , conoutaVis iblaftect . contains , createToolTio . disable , enable . . 
firePtopertvChanoe . firePropartvChance . f iraPropectyChanqe, f irePropertvChanqe , 
firePrcpe rtvChanoe . I irePrope,rtyr;h,a l nq&, giraPcopertyChanqe, f irePropertvChanqe, 
f irePropertvChanqe , f ireVetoableChanqe , qetAct,i,Qn.ForKsySti;oke, cetAct;ionMap, 
q atAlicnnventy oetAliqnmentY , astAutoscroUs. aetBorder, qeteounds, oetClient Property. 
qetCottccnentCraphics , cetCondifcionForKevStroke . oatDebuaGcachicgQcticns . cetGraph;cs, 
qetHeioht . oetlnPUtMap , ceqnp.Ut^ap, cetlnputVerif ier, aetlnseti, qet;Insets, 
aetListeners , oetLocation , getHaximuraSite, qetMinimumSiae, oetKex t Focus ableComoonen t . 
qetPreferredSlze . ce tReo 1 5 1 e redSevS t ro kes . q°tRcotPane, qatSiza, oQ.tToolTipLcca tion, 
qetToolTioText . aetToolT ipTer.t ■ aatToDLeve 1 Ancestor . ffetVgrigYlnputWhengocusTarqpt, 
qatv-jsiblefiect , aetWadth , oetx , oatY , qrabFocus , has Focus , fcid£, isDoublsguEf grqd, 
isFocusCvcleRoct . isFocusTraversable , iaLiqhtweiahtComponent , isMan.aqj.nqFqcus, 
isMaxjjnumSizeSet . isMiniimiipSizeSet . isOoaaue . i sQp t ini zedDrawinqEr.abl ed . isPaintincTila . 
isPreferredSizeSet . isFecuest Focus Enabled , ' isValidateRoot , paint , paintEocder . 
paintChildren . paintConxonent , paintlmmedia t&lv . paintlmrr.ediatelv , prinz. orintAU , , 
PCintBorder , crintChildcen . printComponent , processConponentKevEvent , process FocusEvent , 
orocassKevBinding . procesaKevEven- . processMouseMotionEvent . putClien tProoertv, 
reaisterKevboardAction , reoisterKevboardAction , . removeAncestorListener , removeNotif y, 
renoveProcertvChanaeListener . removePropert vChan qeListaner, removeVetoabLeChangeLis tener . 
repaint , r epaint , -em ias rOef au 1 t Focus , regnes t Fociis , resetKayboapdAct ions, reshape, 
revalidate , sdrol IRectToVisible , SfltflctionHap, se^AUqnjnsntX, sat Alderman tY, 
setAutoacrolla . aetBackqround , setBcrder . set pe^ugGraoh^aOPt; Ions, set;DoubleBuf fered, ■ 
setEnabled . setFont . aetForeground , setlnputMao, se^aputVarieigr, satMaxjpiimSl^q, 
setMinim.jmSize . aetHaxtFocusableCompor.ent . setOpsaug, setPre !;5rr*d5ize, 

getReouastFocuaEnabled . setToolTioText , aetU?, setverif ylnputWhsnFo-usTarqst, aetVlaible, 
unregisterKgybpar±i\c-ion , ypdate 



Methods inherited from class java.awt.Container 

££d» add, add, add, add, adp^rLtaJJX3J:tJLsjftJSifij: . AddZmd* coun tComponent s , -da liverEvant . 
doLavcut , fincCompongnt.At, findComponen tAt , g et Compone nt . ge_^m3^£&nJE.&£, a » tComponen t Afe , 
g gtComponencCoun cT^ggtCpmponentg, getLavcut . in aeta , invalidate . jsAncsstorQ^, laj^jyt, 
.Ltii, list, locate , ctini mu jnSize , paintCorr.Pcnent 5 , href erredSiie , printComoonertts . 
pr ocessCo n tainer Event, processEvent , remove , remove . removeAH, . re moveCon tain a rLd _5 tener, 
s et La yout, validate . yalidateTrse 



Methods inherited from class java.awtCo mponent • 

action, add, addCcm ponentLia tener . addFocusLiatener . addHierarchvBoundSLl s c enej:, 
addHierarchyListaner . addlnoutMe thodLis tener , addKevLiatener , add frlouseListene r , 
adrirtouseMotionListenar , bounds , chec klmaqs, checklmag e, c caleaceSvents , contains. 
~reatelmage , createlmace , disableEvents , dispatchEvent , e nable , ehabl e Eventa . 
sna bleln putHethods . cet Eacicqrou nd. cet Bounds, c etColorMode l, oetComoonen -Orientation, 
qetCursor . qetDrooTa rqet , a etFont , tr e tFontMe trlcs , ■ cat Foreground , 
qetGraphi,p5Co nfiauration . qetrnoutContext , ae tlnputMethodReaues ts , getLccale, 
qetLocation, oetLocat ionOnScrsen , qetName . qetParent , get Peer. qetSize, ■qetToolkit,, 
QLetXr^eLock. oorFocus . handleEvent , .la a qe Up date > inside / isDisplayable, ij.|nab^d r 
isLiohtweicht. isShowina . isValid , IsVtSiMgf KeyPgw n< ]<jayUEr Ililf Ult, Ui£. locaticr. , 
lo st Focus . mouseDown . nouseDraa . mouseEnter . mqU5g£xit> nvQUseljove, pipus^B> move, 
ne xtFocus . paintA ll. ooatEvent . preparelmaae . pre parelmaqe . p roce S 5CQmP0neni£;v,en l , 
procassHierarchyBounda Event , proceasHierarchvEven't , process I nputMethodE vent , 
proc essMouse Event , remove, removeComponentListener , remove Foc us Li a tener, 
removeHiera rehyBoun dsLis tener . re moveHierarchvLis tener , reraove Ino u tMe t hod.L is t e ne r , 
rettv oveKey Lis tener . removeMouseListener , rethovgMouseMoti.pnListener , repaint , xe pain . t , 
repaint, resize , .revise* setBoundS.. setBo^ qdg, agt.ComponentOr^entatiop, sgtCuraor, 
s etPropTar qet, setLocale . setLocation , setLozation . setName . setEiz^e , s , etSiz , e , show, 
ShCiW, size. tcSfcrin a. t ransferFocus 
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Methods inherited from d as; jziva.lang. Obiect 

cJu£HS, eguaj^,, qetClaaa, haahCode, notij^, notifvMl. wait , wait , wait, 



Methods inherited from Interfa ce com.xis.ui. Clioboardl Jser 
iaHandlinq^l^pbOArtPPeraclong.> getHantiUnqCllDboardQc-ffrar i.Qga 

Methods inherited from interfa ce com.xis.uUJJBean 



Field Detail 




RESOURCES 

public static final TvpedReaource Bundle RSSOOUCSS 
localized resources for this view object. 

[Constructor Detail 

ContenrlnfoBean 

public ContentIr.fQ3«an() 

Default constructor that crsatcs en empty ConlcntlnfoBcan. 



Method Detail 




gctContents 

public Object: getCcntantaO 

Fetch the curiectly loaded raw data item 
Returns: 

the currently loaded object, or null if no object is loaded 
setXISNotifying 

public void aetXISNotifyiag (boolean notify) 

Set whether the ContentlnfoBean should update based on XIS events and shculd notify XIS of raw data item 

attribute changes 

Parameters: 

notify - if true then notify XIS, else do not 
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. isXISNotifying 

public boolean iaXISHotltyingt) 

Check whether the Con ten: Info Be an is updating based on XIS events and is notifying X15 of raw data item 

attribute changes 

Returns: 

true if it is notifying XIS, else false 



remov eAllRawDataltems 

public void rojaovQAllS.awDataIt.omaO 

Remove all of the raw data items that are currently. loaded 



getResources 

public TyoecReeou rceS ur.dle getResources ( ) 

Return the ResourceBundle for this Conten- InfoBaan. . 
Overrides: 

qetRasourcas in class Datalte rn SinkUISean 
Returns: 

the statically sourced ResourceBundle. 



infoModelChanged 

public void infoModalChanged ( ) 

Messaged to indicate an InfoModsl change for this InfoBcan or one or more of its LeifDatal terns. This should 

reload all currently loaded data items to pick up InfoModcl changes. 

Overrides: 

InfoModelChanged in class Car.ftUqmSinKUIEaan 



addRawDataltems 

public, void adc^avDataltaaus (Object [ ] rawDatal terns ) 

Add the raw data items in lie array. Will only add if the array has only one object and the object is not the 
■currently loaded rawDataltem. 

Parameters: * 
rawDataltems - the array of objects to be added 



addRawDataltem 

pUDllC void addRawD a tax tan (Object rawDataltem) ' 
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Load the raw data item into the ContentlnfoBean. If the raw data item -supports the ContentDomain and has " 
content of iype that is currently supported then it will be displayed. Otherwise, if content creation is set to true then 
default content will be created, using a JAFAndPropertyComponent 
Overrides: 

a ddRaw fiat altp q in class Pat ajE teatS InkU IBe an 
Parameters: 

rawDataitem - the raw object to display _ 



createContent 

protected void craataCcntontl) 

Method called when there is no content to' display for a raw data item. The default behavior displays a • 
JAFAndPropertyComponent of the object, but subclasses may wish to display something else instead. 



. isCreatingContent 

public boolean iaCreatingCcntent ( ) 

Check.whether default content creation is set. If so then a JAFAndPropertyComponent will be created for items 

that have no displayable content. 

Returns: 

tnie if default content is created, else false 



setCreatcContent 

public void 3etCreateContent ^boolean create) 

Set whether content should be created for objects that do not have any displayable content, via a 
JAFAndPropertyComponent 

Parameters: , 
create ■ if true, create content, else do not 



removeRa>vDataItems 

public void removeRawDataltena {Qbj_ect ( } rawCatalteias) 

Remove the raw data items in the array. Will only remove the object that is currently loaded if it is contained in the ' 
array 

Parameters: 

rawDac a I tems - the array of objects to be removed 



rc mo v e Raw D a t al tern 

public void renoveRawDatal tern ( Object rawDataltero) 
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Remove the given raw data Stem if it is the currently loaded raw data iiem 
Overrides: 

uu^gutaun&fcA itzx in c lass s&uiijs .aSio KHIfisso 
Parameters: 

rawDstalcem- the object to remove . 



geUAFAndPropertyCoraponent 

public JAFAndPgqpqrty Cotnponen t getJAJAndPrcpertyConponent t ) 

Get the MFAr.dPropcrtv component used by the ContentlnfoBcan to display the contents for raw data items that 

have nothing else to display. 

Returns: 

the current J APAndPropertyCamponent being used 



getContainerForContent 

protectod Container getContainorJorCcniont (int indsx) 

Get a container with ths contents of the content objecfat the given index, or nuli if the content type is not 

supported.- Subclass this if you need support for a type that is not already supported. 

Parameters: 

index - the index of in the object 
Returns: 

• a Container with the contents at the given index 



getSeletitedObjects • 

public Gki&CLkU setSelectedObjects {)' • • 

Get an array of selected objects. This will return an empty array if there are no selected objects. If the raw data 

item is selected it will return en array of size I with the raw data item inside • 1 

Returns: 

an array of selected objects 



isSelected 

public bcolaan IsSelected () • 

Check the selected state srthe content object, ifthere is currently one loaded. If there is none, rerurr. false. 
Returns: 

true if there is an object and it is selected 



selectAU 

public void selBctAilO 
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Set the selection state of the object to true. 
Specified by: 

SSlegfcMI in interface CUoboardUser 
Overrides: 

aeiscwai in class GaJLiUaaiS Ufcuiaaan 



seleefcNone 

public void selectEcneO 

. Sec the selection state of the object to false. 



setSelection. 

public void setSelacticr. (boolean selected) 1 

Set the selection state of. the content object 
Parameters: 

the -new selection state 



canCIear * 

public boolean canCIear (] 

Return true if the ContentlnfoBsan has an object and it is selected " 
Specified by: 

canCIear in interface ClipboardUsec 
Overrides: 

canCIear in class Da ta I temSi nkU lBean 
Returns: 

true if the raw data item is selected 
See Also: 

cretselfrf 



canCIear 

public boolean canCleag ( Qb1 ect, ( 1 items) ' 

Return true if the specified items can be cleared If the item is not in the ContentlnfoBean return false. If there is 
more than one item return false. 
Specified by: 

canC\e&_x in interface Cl iEbcazwlUs&r 
Overrides: 

canCleg y in class DatalteroSinkUIBean 
Parameters: 

items • the Array of items to be cut. 
Returns: 

true if <all of the items arc present, otherwise false. 
' See Also: 
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con r. sir. si Ob jeer []) 



canCopy 

pubUc boolean canCopy t) 

Return true if the ContemlnfoBean has an object and it is selected 
Specified by: 

c anCop v in interface Cliobo ardUser ■ 
Overrides: . 

canCopv in class DataltemSinkl-IBean 
Returns: 

true if the raw data item is selected 

See Also: 

ca-tCl&art I 



canCopy 

public boolean canCopy (Object [J items) 

" Return true if the specified items can be copied. If the item is not in the ContentlnfoBean return false. If there is 
more than one item return false. 
Specified by: 

canCopy in interface clicbcardUser 
Overrides: 

canCopy in class flatalt.P.wg i,nHHI££&n 
Parameters: 

items - me Array of items to be cut. 
Returns: 

true if all of the items arc present, otherwise false. 
See Also: 

£aji£learLObjec.tUL 



canCut 

public boolean canCut'.) 

-Return true if the ContentlnfoBean has an .object and it is selected 
Specified by: 

• canCut in interface n rphoardUser 
Overrides: 

canCut in class 03feaItemSinkUI3ean 
Returns: 

true if the raw data item is selected 
See Also: 

ca.r,Clear{) 



canCut 



nubile boolean 'canCut ( Object 1 1 items) 
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Rjrtum true if the specified items can be cut. If the item is not in the ContentlnfoBean return false. irthere is it 
than one item return false. 
Specified by: 

C£B£u£ in interface cuafcpsxdussr 
Overrides: 

canCut; in class Da ealtenvSinkUIBaan 
Parameters: 

items -the Array of items to be cut. 
Returns: 

true if all of the Items are present, otherwise false. 
See Also: 



canPaste 



public boolean can?asta() 

Return true if the ContentlnfoBean can paste new objects, false if not. 
Specified by: 

canPaate in interface Clioboar JUacr 
Overrides: 

C,anfA,8US in class Ca ^ U ^i Pfrt ng eg g 
Returns: 

default is always true for the ContentlnfoBean. 



canSdectAll 

public boolean eanSclectJUI { ) 

Return true if the. ContentlnfoBean can select all abjects. 
Specified by: 

canSelecTiAll in interface qlipbo ardl'se ^ 
Overrides: . 

Cfit\$6i, 9 ctAU in :iass DatalcemSinkUlBean ' 
Returns: 

returns true if there is an objec: end it is not selected 



canSelectNone 

public boole&n canSelectttcne ( ) 

, Return true if the ContentlnfoBean can un-sclcct all objects. 
Returns; 

returns true if the raw data item is selected 



clear ■ 



public void elaar {) '. 
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Notify the ContentlnfoBean to remove the current raw data item only if it is selected. 
Specified by: 

dear in interface ClioboardUser 
' Overrides: 

clear in class O.ajiAXi^LnlsyjCBsari 



clear 

public void clear ( Object ( 1 items) 

Clears the given items. These items only get cleared if they actually occur in the ContentlnfoBean. • 
Specified by: 

in- interface CUp^^rdUaer 

Overrides: 

c;ea ,y in class Ra^mafflSiflJsaifiaafl 
' Parameters: 

■ items - the items to cleared. 



dearAIl 

public void clearAJLK) 

. Removes the currently loaded object. 



copy 

public void copy ( Clipboard clipboard) 

Called to invoke this ContentlnfoBean's copy action, which is to copy all selected data to the Clipboard. 
Specified by. 

copy in interface CJL_ig_fega;dUser 
Overrides: . 

copy in class Data! tenSinkUIBear. 
Parameters:. 

clipboard - the Clipboard object that gets posted to. The actual items posted are contained in a 
LeifTransferable. 



copy 

public void copy {C lipboard clipboard, . 

Object f 1 items) 

Copies the given items into the Clipboard.. . 
•Specified by:" 

coov in interface cii phoardUser 
Overrides: 

cooy in class DataltemSi n k UI Beafl 
Parameters: 

clipboard - the Clipboard object that gets posted'to. The actual items posted are contained in a 



WO 02/46916 PCT/US01/48418 

63/90 



LeifTransferabl:. 

items ■ the array of Object items to copied. 



cut 

public void cut(Cllpboa,rcJ clipboard) . ' 

Cut selected items from the Contenting Bean and post them into Clipboard. ' 
Specified by: 

cut in interface ciioboarduser 
Overrides: 

cot in class Data I tgrnS inkCJIBoan 
Parameters: 

clipboard - the Clipboard object that gets posted to. The actual items posted are contained in a 
leifTransferable. 



cut 

public void cut ( Clipboard clipboard, . ■ 
Gfcl2£r.U iterr^) 

Cut the given items from the CantentLnfoBean and pest them into the given Clipboard only if they occur in the 
ContentlnfoEean. t 
• Specified by: 

cjj£ in interface ciiofaoardusar 
Overrides: 

Parameters: 

clipboard - the Clipboard objec- -hat gets posted to.The actual items posted are contained in z 
LeifTransferable. * 
items - the array of Object items to cut and posted. • 



paste , 

public vc'id paste (CI ibb oard clipbesrd) 

Paste the duta Objects &om the given clipboard. This retrieves the clipboard contents and does a simple add, 
Specified by: 

paste in interface clioboardUsar 
Overrides: 

Parameters: 

clipboard - the Clipboerd that contains the objects, 
See Also: - • 

add&awDatal Leauj (Ob.j act ( U 



• contains 



public final boolean containa ( Oblect f 1 items! 
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Return true if this Cqntcntlnfo Bean contains all the objects of the given array. 
Parameters: 

items - an array of objects to locate in the ContentlnfoBean. 
Returns; 

true if there is only one object and it is contained, false otherwise 



containsComponent 

public boolean «ar.fcainaComponerifc (Component component! 

' Check if thr given component is contained by this InfoBean 
Parameters: 

component * the Component to check for 
Returns: 

true if it is contained, eise false 



getLetfDataltemMenu' 

public JKenu ? **T,«i fn^ai^MiManal Lei f Dataltem dataltem. 

boolean 3nowCutPasteItems) 

Return the data item menu for a LeifDataItenv(usua!l'y the selected LeifDataltem). this is used by the menubarto 
add menuitems from this JMenu to a Data menu if there is exactly one DataltemSelected selected. 
Overrides: 

cetLeifDa ta l t em Me nu in class DataltemSink UIBean 
Parameters:*. 

dataltem - trie LeifDataltem to get the menu fur 

showCut Paste I tems - true to allow cut and paste items to appear, false to omit them. 
Returns: 

the JMenu for the given LeifDataltem 



isDragEnabled 

public boolean isDragEnabled ( } 

Return true if the default Drag support is enabled. 
Overrides: 

IsDragEnabled In class DataltemSlnfrUIBear. 
Returns: . 

true if drag is enabled, false if not, default is initialized to true. ■ 



setDragEnabled 

.public void s etDragEnabled (boolean enabiedrag) 

Set the status of the default Drag support. 
Overrides: 

s etDragEna bled in class C ata I te rns! nkUJgsan 
Parameters: 
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enablsdcsg • true if default drag support should be used, false if not. 



setDragChvnerProxy 

public void setDragOwnerPcoxy ( DraoOwnsr dragProxy) 

Set a DragOwner "proxy" for this Info Bean. 
Overrides: 

JetOraaOwnarPraxv In class Data' temSlrikUTBeaq 
Parameters: 

•drag Proxy - a DragOwner implementation. 



isDropEijabled 

public boolean isDrcpEnablad ( ) 

Return true if the default Drop support is enabled 
Overrides:. 

ISDrooE-iahigrl !n class DatarfcemSinkniBaar. 
Returns: 

true if drag is enabled, false if not, default is initialized to true. • 



setDropEnabled 

public void se^o zopERabled (boolean enabledropl • 

Set the status of the default Drop support. 
Overrides: 

^l^XC.E^.abJjid in class O acaltemSinkCaEean ■ 
■ Parameters: 

enabled cop - true if default drag support should be used, false if net. 



se tD ropOvv n erP roxy 

public 70 id 3 eta rocOwnecPcaxv ( DropOwner dropProxy) 

Set a DropOwner "proxy" for this InfoBean. 
Overrides: 

Parameters: 

dropProxy - a DropOwner implementation. 
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Packagecom.xis.leif.ini 

This package contains classes that provide the APIs for using information management in applications. 



See: 

Description 



Interface Summary 


Attribute 


The Attribute class represents an attribute for a particular data type. 


Attribute Alias 


1 nc n.C t riOUwSnildi IflUlUdlwj ail alias liUill l ..it Aiu luuicj vu a glil^ic alu iuuic, jtutci 

with a precision level; the higher the precision, the better the alias. 


Attribute Factory 


The AttributeFactory class allows an implementor to return an appropriate Attribute for 
the given LeifDataitem. . 


A.ttribufeLookup 


The AttributeLookup interface is used to lookup Attribute objects for a particular data 
item. • . . 


PJspJgxLgbe! 


The DisplayLabel Interface defines methods that are needed for use with 
DisplayLabelAttributes. 


Domain 


This interface describes the basic fields and methods possessed by all Domains. 


Info Mo del 


The InfoModel interface is the interface that is used to convert raw data items into 
LeifDatal terns. 




The LeifDataitem interface represents a simple data item. 


L eifD at a It em Observer 


This class is used for observering a LeifDataitem to know when it has finished processing an 
action. 


LiteDataftem 


The Li teDataltem interface represents a data item. . 


PropertvProvider 


If a PropsrtyProvider implementation is added to services it can be used to replace the 
standard behavior when a PropertySheetView is opened from a JAF menu or as adefault 
command. * 


RawDntaltemLookup 


The RawDataltenLookup interface is used to look up a raw data item from a unique id. 



Class Summary 


AbstractAttribute 


The AbstractAttribute class represents an Attribute. 


AttributeAliasPIuggableService 


This register Attribute Aliases. 


A tt r i buteD es c r i pjor. 


The AttributeDescriptor class is used to describe an 
attribute without providing functionality of how to use the 
attribute. 


AttributeDescriptorFactory 


The AttributeDescriptorf actory class is a singleton 
class used to create or get AttributeDescriptors. 


Attn bute Facto ry In fo M od e IS u bset 


The AttributeFactorylnfoModelSubset class 
provides an InfoModel that will add the Attributes specified 
by the AttributeFactories to all LeifDataltems this 
InfoModel creates. 



WO 02/46916 



67/90 



PCT7US01/48418 



A ticlbjilcGet Request 


ThS A.C t r i bll tfiGe t R.60US5 t da?? U??H \r\ nBrl-irn*. all 
***** nv u v t i w w w *s w 4\ ci^u a a i. uiqm • -J UawlJ \\J DilCKtlSe all 

the necessary parameters for getting the value an attribute. 




The ActribucelcckRequest class- bundles attributes 

nap/nor) tn niin ;^rpct tn !/•<■» J 1 - ■' fr\ - . - t . - 

ucecca io giim ci.t_ci5 io locKeo Leiiuaiflitenrs. . 


Attribut.es 


i uc fttt *. 3.DJCC3 ia b woniaincr ror noicing suriouies. 


Attrjbut.e.Se.tRejiues.t 


The AttributeSetRequest class is used to package all 
the necessary parameters for setting an attribute. 


BaseJ)ataJtem 


The 3aseCa.t altera is the first wrapper around raw data ' 
items. 


B.aselurofflpdeJ 


//PENDING (RK): Any method marked with "PENDING" in 
the JavaDoc will //liicely be removed before XIS is released 
in final form. 


. BascInroModel^eK'^esProvider 


The BaseInfoMadel£ecvices?rovider class will ■ 
provide all the services available from the BaselnfoModel 
to the given BeanContextServices object 


CP i 1 iQ ti o n P ro p_e r t i i es 


This class populates JAFMenus for generic collections. 




The DataltemActionManager class provides some useful 
static methods for dealing with actions on LeifDataltsms. 




This class is an aciionList-ner to be. used with 
LelfReference "Load" menus. 




Qa.taltemMejiuSW 


The Da tal temMenuSet class is used by the - 
LeiOAFUtilities class to return essentially a Dataltem 
popup menu with annotation. 


.Cla talterjijyj enu£et.ftijry_ 


The Oa tal temMenuSet. Entry class encapsulates a 
Dataltem and it's menu, and also provides some 
convenience methods for adding additional menu Items. ■ 


DeraultWrapperAttribtite 


The OefauliW reoperAt tribute class is a generic 
attribute that is the superclass of all defaults in generated 
domain attributes. 


DisobvLabclAtlrihute 


The DisplayLabelAttribute diss is used to display 
one or more Attribute values in conjuction with string 
literals specified by users. 


DJsplayUfaelGiUa 


The DisplayLabeLData class is used by the 
DisplayLabelAttribute to store a mapping of 
LeifDataliems to DisplayLabelTemplates. 


DispJnyLabelTem plate 


The DisplayLabeiTa.nplate class is used by the 
DisplayLab9lAttributa to compute and store editing 
and rendering values fo~ ev*rv LeifDataltem that has rh*» 
attribute. 


DomainMethnrf 


Abstractly represents a'Dcmain Methad. 


Dornaii.fVtethnt] Descriptor 


The DumainHettiodDtiscrlpcor class is used to describe 
a DomairuMethod. 


Qmn ajjJNleJhod DcscriptorFactory 


The DomainMschodDe scrip tor Factory class 15 a 
singleton class used to create or get 
Doma inMe. t hod De .<? r r i bj^S. 


DomainWrapper 


This class adds methods to LeifDataltem de legator that are 
useful in the domain wrappers. 


DvnamicArtributes 


The Dynamic At tributes class is used for storing ■ 
dynamic attributes. 
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FieldMetaData 


FieldMetaData specifies sorting and subset criteria for an 
attribute. 


FieklJVletaDalas 


The FieldMetaDatas class represents a collection of 
FieldMetaData For a data item. 


InfoModelDataltem 


The InfcHodsIDataltera allows views to wrap 
LeifData Items and adaVremove/modify attributes thai will 
only affect that view. 


InfoiVlodelSubset 


Typically when creating an InfoModel to nest within an 
existing InfoModel, which is done by'ViewUlBeans, an 
InfoModelSubset is used. • 


J nv a M Wrap pe.t£ ttrj bytg 


The InvalidWrapperAttribute class 


LetfDatnltemComparator 


The LeifDataltemComparator compares LeifDataltems by 
AttributeDescriptor suppl ied by the user. 




Implements the methods in LeifDataltem in a wrapper so 
you don't have to. 


LeifDalaltejnSorter 


The LeifDataltemSorter provides a default sorting tool for 
all LEIF LeifDataltem objects. 


LeifDatartemUpdate » 


This classes is used with the LeifDataltemObserver. 


Leiflnitialization 


The Lciflnitialization class handles some standard 
initialization for most XIS Applications. 


LeifJAFUtSlities 


The Leif JAFUtili ties class provides some useful static 
methods for LEIF-related JavaBeans Activation Framework 
(JAF) processing. 


Leif JA Futilities LeifReferenceActionListener 


This class is an actionListener to be used with 
LeifReferenc; "Load" menus. 


LeifReauesr 


The Lei f Reques t class is used to package all the 
necessary parameters for requesting information for a 
LeifDataltem. 


U^Xransa_pt.ion 


The Leif Transact ion class is used to construct a 
transaction. 


ko^MdJ-jeiroa.tjLltem 


The LockedLeifDataltemclass is used to enable locking 
on the data item. 


MethodRequest 


The MethodRequesc class is used to package all the 
necessary parameters for invoking a DomairuMethod for a 
LeifDataltem. 




Mutable subclass of AttrlbuteOescrlptoc. 




This class provides useful support for using the 
LeifDataltcmObserver. 




The RequestPool class is used to assist Object pooling. 


Resources 


The Resources class is automatically generated and must 
be public, but it is intended to be used only by Java's 
internationalization support classes. 


SelectnbteDataUem 


Creates a wrapper around a LeifDataltem for a 
SelectablelnfoModel, 


SelectablelnfoMode! 


Manages selections for :he selectable leif data items that are 
contained within this model. 




A major design goal for XIS was to provide the ability to 
integrate existing data item classes without modifying them. 
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Transla^rRegLstry 


Provides a centra! location for maintaining Translators, 
extended Translators and locating domain methods on data 
items. 




The UndezinedAt tribute class represents ar. undefined 
attributes. 


yijibLliiyAitribute 


The visicilityAt-cLbuta class is an Attribute that is 
ready to use for LeiDataltem visibility. 



Exception Summary 


Data ItemNotFnn nrt F.t rP pfinr 


The DataItemNotround2x=option class is an exception that can be thrown 
when rrytng to look up a data item from an id 


Loya 1 id Qbj ectS cJi_ern.aEjcep.Uorj 


Signals that there wis a problem with the creation or modification, of an 
ObjeciSchema. 


TranslatorException 


The TranslatorException class 


UnconvertibleAlias^^ce.ptinn 


Indicates that the requested attribute alias could not be calculated or convened. 


UndeflnedLeirAttributeExtepHon 


Indicates *hat the requested attribute is not applicable for the object. 


UndefinedLeirMeihoaFA-c^tirn 


The UndennsdLeifMaihorJException class indicates that the data item does not 
define tne method. 


UnrempvableAttribttteEN-Cfplion. 


The Ur-removablcAttribuieException class indicates an attempt to remove an 
Attribute that was defined by the raw data item (either by reflection or a 
Translator.) Only additional Attributes added'to LeifDataltems can be removed. 
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com.xis.leif.im 

Interface InfoModel 

All Superinterfaces: 

BeanContextChildOwner . BeanContextC hiidOwnerDelegator. BeanContextProxy 

AH Known Implementing Classes: 
InfoMbdelSubset 



public interface InfoModel * 
extends JfeanCooLexlClij^ • 

The InfoModel interface is the interface that is used to convert raw data items into LeifDataltems. The InfoModel should 
hold each of these LeifDataltems created using weak references, so that the data items can be cleaned up when they are no 
longer being used. //PENDING (RK): Any method marked with "PENDING" in the JavaDoc will likely be removed 
before LEIF is released in final form. 

Since: 

LEIF 4.0 ■ 
Version: 

SRevision: .1.20 S, SDate: 2001/08/17 00:54:54 $ 
Author: 

David Almilli 



Method Summary 


void 


activateOneOfNServica (Object service) . 

//PENDING(RK): This method will probably be removed from InfoModel! Notify the InfoModel 
that the given service is the preferred service of its type, and that this particular object should be returned 
if its class is requested, until removed or until another object of the same type is passed to a future call to' 
this method/ 


void 


addlnfoModelListener ( Inf oModelListener listener) 


Adds a listener to this InfoModel so that the listener will be informed of changes to the InfoModel. 


void 


addOneOfNServi.es (Object service) 

//PENDfNG(RK): This method will probably be removed from InfoModel! Add an object as a 
service to be retrieved by a call to getServiceQ (via BeanContext APIs) on any class that this object 
implements or extends. 


void 


clearSelection ( ) 

Clears the selection. 


L-iCOatalcem 


d ump ( ) 

Gives a list of all the Lei fDatal terns currently in the InfoModel. 


n 


EsCop^s£ 


qetEzContext ( ) 

Gets an EZ Context that corresponds to this InfoModel so the developer can use the EZ APIs. 
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Lsl t *;t Tr «t 


ge t Le i f D a t a I ten ( 1 c n g u i d ) 

This will attempt to lookup a LeifDataltem from an id. 


I - j r _ - • _ ^ 


getLeifOataltem (Object cawDacal tera) 

This will wrap a raw Java Object with a LeifDataltem wrapper so you can use it in !eif as.a data • 

item. 




getL«i^a^Lt«?tn{Qbiect rawDataltera, boolean creace) 

This will wraD a raw lava Ohreet with a f pifnataftpm wrnnnpr en \tmt r«m nc» it In loi r-»r « j„im 

in id »'iu "mp ** tan jbvo wuj ™ i ui a L^CI ll_saLal l Cl 11 vv \ cijJIJCJ ju YUU LaJl USC 11 in 1511 35 3 CSCS 

item. . 


1 1 


getLeifDatalteais (Obiect 1 1 rawOatal terns ) : • 

i ma uuiivciiiciiuc nismuu win wrap tin array or rawjava VJOJCCCS- wun LeitUataitem wrappers SO '. 
you can use them in le if as Lei fData Items. 




getFarentlnfoMpdel {) • 

Provides access to the parent InfoModel that this InfoModel delegates to. 


flMar-r 1 1 


qetSelectedP.awDatal terns ( ] 

Gets the list of all the currently selected items for this InfoModel 


Gbiecc 


get S i ng le Selected! ten ( ) 

Get the selected raw data item, if only one. 




getVievHcst [} ' " 

Gets the VicwHost that this InfoModel is associated with. 


void 


removelnf oModelLis tener ( tnf oModelLis tener listener) 

Removes a listener from this InfoModel so that the listener will no longer be informed of changes 
to the InfoModel. 


vole! 


remcveOneOfNServi.ee (Object servica) 

//PENDrNG(RK): This method will probably be removed from InfoModel I Remove an object that 
was a service to be retrieved by a call to getServiceQ (via BeanContext APIs) ori any .class that this 
object implements or extends. 



Methods inherited from interface com.xis.beans.beancontext. BeanContextChildOwnerDelegator 
initlaUgs^ear.Contey.tRescurces. raleaseEeanContaxcRssourcas 



Methods inherited from interface com.xis.beans.beancontext.BeanContextCluldOwner 
9 etpvned Be. an Co n Lex tCh i 1 d 



Methods inherited fro m interface jflva.beans.beancontextB&fln Con t extProx' 
get Be anContext Prox y 



Method Detail 



getLeiJDulaltem 

public kei£pa taltem get£eifDataItem( long uid) 

throws DataltenNotroundExceotion 

This will attempt to lookup a LeifDataltem from an id. If the DID is Invalid or there isn't a LeifDataltem that 

already exists with that given UID, an exception will be thrown. 

Parameters: 

uid - the unique id for the raw data item. 
Returns: 
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the LeifDataltem with the given UID 



getLeifDataltem 

public LeifDa.£ai£egi getLeifDataltem (Cfeisc_£ rawDataltemJ 

This will wrap a raw java Object with a'LeifDataltem wrapper so you can use it in leif as a data item. 
Parameters: 

rawOataltera • the raw data that will be wrapped (Note: this should not already be a LeifDataltem) 
Returns: 

the wrapped data item. 



getLeifDataltem 

public LeifDataltem getLeifDataltem {Ob jject rawDataltem, 

boolean create) ■ 

This will wrap a raw java Object with a LeifDataltem wrapper so you can use it in leif as a data item. 
Parameters: 

rawDataltam - the raw data that will be wrapped. (Note: this should not already be a LeifDataltem)' 
create - if false and the LeifDataltem is net already in the model, don't create one and return null 
. Returns: 

the wrapped data item, or null if "create" is false and not found 



getLeifDataltems 

• public LeigDa'caltSfn n gatLeifTJataltems (Qbiec£ [ ] rawDataltems) 

This convenience method will wrap an array of raw java Objects with LeifDataltem wrappers so you can use them 
in leif as LeifDataltsms. Note that you can get an array of raw data items often irom methods like getMembersO, 
so this is a useful method to have. * • 

Parameters: 

rawDataltems - the raw data objects that will be wrapped. (Not er the objects should not already be 
LeifDatalJems) ■ 
Returns: 

the corresponding wrapped data item array. 



.getEzContext 

public EzContaxt gatXzCo.ntaxt ( ) 

Gets an EZ Context that corresponds to this InfoMode! so the developer can use the £Z APIs. 
Returns: 

the zz context for this info model 



getSingleSelectedltem 

public Object getSingleSelec-edltemO 
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Get the selected- raw date item, if only one. Else return null. . 
Returns: 

the.selected item if there is only one. 



getParentlnfoModei ' 

public In:ot : lc»d9l getParantlnfoModel { ) ' 

Provides access to the parent InfoModel that this InfoModel delegates to. If there is no parent modei then this will 

return null. . 

Returns: 

the parent InfoModel 



clearSelection 

public void clBarSelectiorx() 
' Clears the selection. 



getSelectedRawDataltcms 

public Object 1 1 getSclect.edKawDat.aI tens () 

Gets the list of all the currently .selected items for this InfoModel 
Returns: 

all of the selected data items (as raw data items) 



activateOneOfNService 

* . p 

public void activateOneOfM Service ( Object service) 

//PENDING(RK): This method will probably be removed from InfoModel! Notify the InfoModel that the given 
. service is the preferred service of its type, and that this particular objee: should be returned if its class is requested, 
until removed or until another object of the same type is passed to a future call to this method. 
Parameters: 

service - the object to become the preferred service 



addOneOfNScrvice 

public void addOneOfNSarvj.ce ( Obi ect service) 

//PENDING (RK): This-method will probably be removed from InfoModel! Add an object.as a service to be 
retrieved by a call to getService() (via BeanContext APIs) on any class that this object implements or extends. 
Parameters: 

service - the object to be returned when requested 
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removeOneOfNService 

public void removeOp.eOfilSQrvica (Object service) 

//PENDrNG(RK): This method will probably be removed from InfoModel! Remove an object that was a service to 
be retrieved by a call to getServiceQ (via BeanContext APIs) on any class :hat this object implement or extends. 
Parameters: 

se rvice - the object to be removed from service 



getView.Host 

public KJLftHHaSf getViewHost <} ' # 

■ Gets the ViewKost that this InfoModel is associated with. If this InfoModel is not associated with a Viewtr'ost then 
this will. re turn null: - 
Returns: 

the view hosfthat is maintaining this InfoModel. 



addlnfoModelListener 

public void adtiinf oMo de ILis tsr.e r (In foHoc e IListens r listener) 

Adds a listener to this InfoModel so that the listener will be informed of changes to the InfoModd. 
Parameters: 

listener - the listener to add 



removelnfoModelListener 

j 

public void r^ovelnf oHod-ellis tener ( Inf cMocelLia tensr listener) 

Removes a listener from this InfoModel so that the listener will no longer be informed of changes to the 

InfoModel. 

Parameters: 

• listener - the listener io remove 



dump 

public LeifPataltgai M dump ( ) 

Gives a list of all the LeifDataltems currently in the InfoModel. It is highly recommended to use this method only' 
if you absolutely have no other way of accomplishing the task you need to do. Please keep in mind that if you hold 
onto the LeifDataltems contained in the array returned or if you hold onto the array itself, the items will not be 
removed from InfoModel until you release them. If you wish to hold onto them, you should wrap them in ' 
We&kReference objects. 

Note: fVhen you use the dumpQ method in combination with the addlnfoModelListener so that you can keep track 
of the same set of LeifDataltems as the InfoModel you can synchronize on the InfoModel 10 get the dump and 
then add a listener to recehe events of future changes. 
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Example: 

synchronized (infoModei) { 

Lei£DataItem[ ) dataltems =» infoModei .dump () ; 
infoModei. addlnfoMode 1 Listener (this) ; 
for (int i=0; i < datalteras . length; i++) ( 
process It em (dataltems [i] ) ; 

I- 

') 



Returns: 

the list of LeifDataltems currently in the InfoModei, 
See Also: 

Weakfieference 
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Package com.xis.leif.event 

This package contains classes for handling events in XIS. 



See: 

Description 



Interface Summary 


In foModelListener 


The Inf oModelListener is used to monitor changes to an InfoModeL 


LeifDataltemListener 


This class is used for listening to LeifDataltems for various events. 



Class Summary 


AttributeChanaedEvent 


An AttnbuteCnanged event gets delivered wnenever a oata item 
changes an attribute value. 


ContainerAddedEvent 


A "ContainerAdded" event gets delivered whenever a data item is 
contained as a member in a new object. 


ContainerRemovedEvent 


A "ContainerRemoved" event gets delivered whenever a data item has 
been removed as a member from a containing object. 


DataltemReplacedEvent 


The DataltemReplacedEvent class is used to indicate member changes 
of a containing data item. 


InfoModelEvent 


The InfoModelEvent gets delivered whenever a LeifDatalteirt is created 
by the InfoModel, or when a LeifDataltem has been "lost" 'by, the 
InfoModeL 


InfoModelEventSupport 


The InfoModelEventSupport support class provides basic support for 
managing listeners on an InfoModel. 


LeifDataltemAdapter 


The LeifDataltemAdapter class provides support for setting up a 
LeiiDataltemListener on a data item. 


LeifEventSupport 


This, is a utility class for XIS developers to use when they want to fire 
event changes. 


MemberAddedEvent 


The MemberAddedEvent class indicates that members were added to 
this data item. 


MemberEveat 


The MemberEvent class is used to indicate members changes of a 
containing data item. 


MemberRemovedEvent 


The MemberRemovedEvent class indicates that the members are being 
removed from the containing data item. 


ReferenceAddedEvent 


The ReferenceAddedEvent class indicates that LeifReferences were 
added to the LeifDataltem. 


ReferenceEvent 


The ReferenceEvent class indicates changes to the LeifReferences of 
the data item. 
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ReferenceRemovedEvent 


The ReferenceRemovedEvent class indicates that LeifReferences were 
removed from the LeifDataltem. 


ReferrerAddedEvent 


The ReferrerAddedEvent class indicates that a Referrer was added to 
the data item. 


ReferrerRemovedEvent 


The ReferrerRemovedEvent class indicates that a Referrer was 
removed from the data item. 



Package com.xis.leif.event Description 

This package contains classes for handling events inXIS. 
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1 : addRawDataltem 
y 



2 : getLe'rfDataltem 



3 : newO 



J 4 : addLeitDataltemUstenerQ 



5 : interrogate (get Attributes, etc) 



if 



Figure 36C 
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Data Source (DSL etc). 



lnJoflaan 




InfoModel 

i — . , 




LeifDataltem 



1 1 : Data updated 



I n d tyijd.a a [' o ty Is ^ap|ire| 




(jroperty change event 



3 : attributeChanged 




D o m a I nWra pplr- APIs f:0 



U 



4 : attributeChanged 



5 : se[tAttributeO 



Figure 36D 
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Figure 37A 

TestHarness.java 

I* XIS Tutorial standalone sequence example 5 XIS interfacing. */ 

import javax.swing.JFrame; 
import java.awt.event.WindowAdapter; 
import java.awt.eventWindowEvent; 
/*{*/ 

import java.awt.GridLayout; 

import java.awt.Toolkit; 

import java.awt.Dimension; 

import java.awtevent.CornponentAdapter, 

import java.awtevent.ComponentEvent; 

import javax.swing JSpIitPane; 

import javax.swing.JComponent; 

import jcIass.chart.JCChart; 

import com.xis.Ieif.im.BaselnfoModel; 

import com.xis.plot.PlotlnfoBean; 

import com.xis.plotchartviews.LeifChartView; 

/*{*/ 

import com.xis.table.TablelnfoBean; 
import com.xis.tree.TreelnfoBean; 
/*}*/ 

public class TestHarness { 

public static void main(StringQ args) { 

// the piugin manager is only required for more complex applications 
// involving multiple components integrated at runtime 
BaselnfoModel.setStartingPluglnManager(false); 



/*{7 



HelloWorld hellol = new HeIloWorld("First HelloWorld object."); 
HelloWorld hello2 = new HelloWorld( M Second HelloWorld object"); 
HelloWorld hel!o3 = new HelloWorldCThird HelloWorld object."); 
HelloWorld hello4 = new HelIoWorld("Fourth HelloWorld object."); 
HelloWorld helloS = new HeIloWorld("Fifth HelloWorld object."); 
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Figure 37B 

Continuation of TestHarness.java 



ObjectQ heiloArray = new ObjectQ { hellol, hello2 f hello3, he!!o4, 
hello5 }; 

// create table and plot infobeans to display HelloWorld objects 
TablelnfoBean table = new TablelnfoBean(); 

/*}*/ 

PloilnfoBean plot = new PlotlnfoBean(); 
plot.setChartType(JCChart.BAR); 

//the alternatives are SCATTER_PLOT, PLOT, AREA, PIE, CANDLE, 
// and STACKINGJ3AR, though not all will make sense in this example 

// We can set the attribute for initial display on the plot; 
// see step 3 for further comments. 
plot.setYAxisAttribute( 

"com.xis.domains.movementMovementDomain.speed"); 
plot.setDynamicAd]ustment(true); // so axes track value magnitude 
plot.setBarChartAdjusting(true); // needed in some cases for bar chart 

/*{*/ • 

// a top-level frame as before to hold both plot and table side-by-side 
JFrame tablePlotFrame = new JFrame( ,, HelloWorld(s) Table/Plot"); 
// use a repaired JSplitPane (see below) to manage the two beans 
SaneJSplitPane splitpane = new SaneJSplitPane(tabIe,p!ot, 
new Dimension(table.getPreferredSize().width + 
plotgetPreferredSizeQ.width, 
Math. min(table.getPreferredSize(). height, 
plot.getPreferredSize().width)), 

0.50); 

tablePlotFrame.getContentPaneQ.add(splitpane); 

tab!ePlotFrame.pack(); 

tablePlotFrame.setVisible(true); 

// a tree infobean to display our HelloWorld objects 
TreelnfoBean tree = new TreelnfoBean("HelloWorld(s) Tree"); 
tree.addRawDataltems(helloArray); 

// a top-level frame to hold our tree infobean 

JFrame treeFrame = new JFrame("HelloWorld(s) Tree"); 
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Figure 37C 

Continuation of TestHarness.java 

// avoid placing the windows on top of one another if we can 
int cutoffHeight = 424; 

if (Toolkit.getDefauitToolkit().getScreenSize().getHeight() > 
cutoffHeight +.200) { 

treeFrame.setLocation(348,cutoffHeight+7); 

} 

7 

// add a listener for window closing 
treeFrame.addWindowListener( 
new WindowAdapterQ { 

public void windowClosing(WindowEvent e) { 
System.exit(O); 

} 

} 

); 

// stick the tree infobean in the frame and display it 

treeFrame.getContentPane().add(tree); 

treeFrame.pack(); 

treeFrame.setVisible(true); 

}//main 



r 

* This class overrides the default JSplitPane to provide a reasonable 

* resize behavior: maintain the left and right panels in the same 

* proportions. 
*/ 

public static final class SaneJSplitPane extends JSplitPane { 

private int lastWidth; 
private double lastDividerProp; 

public SaneJSplitPane(JComponent leftComponent, 
JComponent rightComponent, 
. Dimension dims, double startProportion) { 
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Figure 37D 

Continuation of TestHarness.java 

super(JSp!itPane.HORIZONTAL_SPLIT, 

leftCornponent, rightComponent); 
setSize(dims); 

// Since the JSplitPane doesn't set the lastDividertocation 

// variable, nor does it provide any other easier way to maintain 

// the split proportion on resize, we must track the divider 

// location ourself. 

lastWidth = dims.width; 

lastDividerProp = startProportion; 

setDividerLocation(startProportion); 

// this listens for resize events on the splitpane and makes sure . 
// we keep same split proportions 
addComponentListener(new ComponentAdapter() { 

public void componentResized(ComponentEvent event) { 
setDividerLocation(lastDividerProp); 
lastWidth = (int)event.getComponent(). 
getSize().getWidth(); 

}}); 

// only way to know if divider moved by user is to listen for 
// resize events on the components; this isn f t foolproof (since 
// resizes can come from other sources) but it works well enough 
leftComponent.addComponentListener(new ComponentAdapter() { 
public void componentResized(ComponentEvent event) { 
// we add in getDividerSize() / 4 to compensate for a 
// bug in JSplitPane which doesn't take account of the 
// divider width in location-proportion conversions 
lastDividerProp = (double)(getDividerLocation() + 
(getDividerSize() / 4)) / lastWidth; 

} »; 
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Figure 38A 



HelloWorld(s)Tree 



<p" First HelloWorld object. 
9"-E3 Second HelloWorld object 
^-£3 Third HelloWorld object 
<p"E3 Fourth HelloWorld object 
©" £3 Fifth HelloWorld object 
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Figure 38B 
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First HelloWorld object 
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Fourth HelloWorld object 
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COPY 




Figure 38C 
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Interface AttributeAlias 



public interface AttributeAlias 



The AttributeAlias indicates an alias from L.n Attributes to a single Attribute, together with a 
precision level; the higher the precision, the better the alias. The alias allows a caller to query for one 
of the 1 ..n "from" attributes and get the value stored by the data item under the "to" attribute, possibly 
mediated by some conversion, such as a units transformation. 

If the converted or calcuated value cannot be determined, then the At tribute#getvalue ( ) method 
should throw an UnconvertibleAliasException . This Exception is a subclass of the 
UndefinedLeifAttributeSxception which is typically thrown by normal Attributes in this case, 
and it can provide a descriptive message indicating the source of the incompatibility. 

The utility of attribute aliases may be seen by considering the following example: . 

The user has performed a query from an external data source and retrieved a set of Airfields, indexed 
by an ICAO identifier. The user now wants to get the list of Aircraft at one of the airfields. There is a 
local aircraft database with a foreign key field for Airfields, but that key is a WAC identifier, not 
ICAO. 

Assumption: The application was NOT written ahead of time to know about these two databases or 
their ID types. Instead, what you have is an XIS "Leif Dataltem" for the Airfield, and you have an - 
XIS InfoBean for the Aircraft query form. ' 

What you want to do is to copy (or "drop") the Airfield data item into the "WAC" field in the query, 
form. In doing this, the Form will ask the data item for its "WAC" attribute (because this is all it 
knows about). It uses the "getWAC ( ) " method from some domain (say, the Airf ieldDomain). 

The way this could work is that there would have to be an AttributeAlias defined to convert ICAO 
to WAC - or, more specifically, AviationDomain.'ICAOto Airf ieldDomain. WAC. The 
AttributeAlias returns an Attribute object that knows how to transform ICAOs to WACs (e.g., 
by accessing a conversion table). The Attribute, in turn, has a getvalue ( ) method to execute that 
transformation and return the WAC. 

This process would be entirely transparent to the user, or even the' caller, who would just see a result 
returned from the getWAC ( ) method. In cases where the conversion was not possible, the 
UncorwertibleAliasException would.be thrown, possibly providing informative information to 
the caller or user. - 

Finally, note that due to the way the mechanism is set up (using resources and a pluqcableService) , 
this AttributeAlias can be installed as a separate module without requiring any re-coding or re- 
compilation of the existing application. ■ " 
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Method Summary 


AttributeDescriptor 


getAliasedFrom ( ) 


[I 


.This indicates which AttributeDescriptors (which in turns means which 
Attributes) are required for the alias. 


AttributeDescriDtor 


aetAliasedToO 

This indicates the AttributeDescriptor that this AttributeAlias is for. 


Attribute 


qetAt tribute ( ) 

. Get the Attribute object that is the alias Attribute. 


int 


qetPrecisionPriority I ) 

This indicates the precision of the AttributeAlias. 



Method Detail 



getPrecisionPriority 

public int getPrecisionPriority ( } 

This indicates the precision of the AttributeAlias. The higher the number the better the alias. 
This number is used to determine which AttributeAlias to use when there are more than one 
alias for a given Attribute. 
Returns: 

the precision of the alias. 



getAliasedFrom 

public AttributeDescrip tor f 1 getAliasedFrom ( } 

This indicates which AttributeDescriptors (which in turns means which Attributes) are required 

for the alias. . 

Returns: 

the list of descriptors required for this alias. 



getAliasedTo 

public AttributeDescrip tor getAliasedTo ( ) 

This indicates the AttributeDescriptor that this AttributeAlias is for. 
Returns: 

the descriptor that this alias is for. 
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getAttribute 

public Attribute getAttribute ( ) 

Get the Attribute object that is the alias Attribute. This attribute is responsible for performing 
the translation from the aliased from Attributes. The AttributeDescriptor of the Attribute 
MUST be the same AttributeDescriptor returned by getAliasedTo. 
Returns: 

the attribute that will do the translation. 
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